X (formerly Twitter)

WCMS 3 supports X (formerly Twitter) integration that allows users to add an embedded tweet, profile, or list to their page. Note that due to changes made by Twitter, these may not be reliable, displaying “Nothing to see here - yet” for many users.

You can also control how your WCMS 3 page is displayed in Tweets linking to your WCMS page.

For more information on the block, visit X (formerly Twitter) in our Block library.

The Embedded Tweet option embeds a single tweet onto a content page.

From the administration bar, select Workbench, and then select My Dashboard.
Navigate to the Content list panel and select the content you would like to edit. Alternatively, create a new web page.
Select the Layout tab.
Select + Add section, if applicable.
Select + Add block. Under External Embeds, select X (formerly Twitter).
Enter a Title. Select whether you want it to display or not by checking/unchecking the Display title box. The title will appear as a block heading if Display title is selected.
Select Embedded Tweet from the X (formerly Twitter) feed type drop-down menu.
On Twitter, select the three dots in the top right corner of the tweet you would like to display and select </> Embed Tweet.
In the embedded tweet window, select Copy Code.
In WCMS 3 Configure block dialogue, and paste the embedded tweet code in the Tweet code field.
Select Add block (Or Update if it is a pre-existing block).
Select state from the Change to: drop-down menu.
Select Save layout.

The X (formerly Twitter) Profile option displays the tweets from a single X (formerly Twitter) account.

From the administration bar, select Workbench, and then select My Dashboard.
Navigate to the Content list panel and select the content you would like to edit. Alternatively, create a new web page.
Select the Layout tab.
Select + Add section, if applicable.
Select + Add block. Under External Embeds, select X (formerly Twitter).
Enter a Title. Select whether you want it to display or not by checking/unchecking the Display title box. The title will appear as a block heading if Display title is selected.
Select Profile from the X (formerly Twitter) feed type drop-down menu.
Enter the X (formerly Twitter) username. This is the Twitter handle without the "@" sign, not the profile name.
Select Add block (Or Update if it is a pre-existing block).
Select state from the Change to: drop-down menu.
Select Save layout.

Here is an example of a X (formerly Twitter) embed that features a profile and allows users to navigate through its tweets:https://twitter.com/UWaterloo?ref_src=twsrc%5Etfw%7Ctwcamp%5Eembeddedtimeline%7Ctwterm%5Escreen-name%3AUWaterloo%7Ctwcon%5Es2

Note: The "View on X (formerly Twitter)" link at the bottom of the block is fixed and cannot be removed.

X (formerly Twitter) lists consist of X (formerly Twitter) accounts compiled by a user. The Twitter Block will list the account that created the list as "Tweets by @[account name]/[list name]".

In X (formerly Twitter)

Log in to your X (formerly Twitter) account.
Select Lists from the left navigation bar.
To the right of Lists and your username, select the New List icon.
Add a Name and an optional Description, then select Next.
Enter the usernames of accounts you'd like to add to the list in the Search Bar (ex. @UWaterloo).
Beside the profile name, select Add to add the account to your list.
Select Done.

Add the List to WCMS 3

From the administration bar, select Workbench, and then select My Dashboard.
Navigate to the Content list panel and select the content you would like to edit. Alternatively, create a new web page.
Select Layout tab.
Select + Add section, if applicable.
Select + Add block. Under External Embeds, select X (formerly Twitter).
Enter a Title. Select whether you want it to display or not by checking/unchecking the Display title box. The title will appear as a block heading if Display title is selected.
Select List from the X (formerly Twitter) feed type drop-down menu.
Enter the X (formerly Twitter) username.
- Note: This is the X username without the "@" sign, not the profile name.
Enter the List name.
Select Add block (Or Update if it is a pre-existing block).
Select state from the Change to: drop-down menu.
Select Save layout.

Twitter Card meta tags allows you to control how your WCMS 3 page is displayed on a Twitter Card when a Tweet links to your WCMS page.

You only need to use this if you want to provide different information to Twitter than is set in the basic tags.

WCMS supports four types of Twitter Cards:

Summary Card (Default)
Summary Card with large image
App Card
Player Card

From the administration bar, select Workbench, and then select My Dashboard.
Navigate to the Content types panel. Select the web page you would like to edit from the Content list panel.
Select the Edit tab.
Select Advanced configuration.
Navigate to the Twitter cards panel.
Select Twitter card type.
In the Description field, add a description that summarizes the content of the page. The character limit is 200.
If required by the card type selected, enter the title of the page in the Title field. The character limit is 70.
Optionally, enter the Creator’s X (formerly Twitter) account. This is the @username for the account. The "@" symbol needs to be included when entering the account.
Optionally, enter the Creator’s X (formerly Twitter) account ID. This is the numerical account ID for the creator/author.
Enter the Image URL, if applicable.
Enter alternative text in the Image alternative text field, if applicable. The alt text is a description of what is in the image, not a caption.
Enter the Image width and Image height, into their respective fields, if applicable.
Populate any other required fields for the selected card type.
Select state from the Change to: drop-down menu.
Select Save.