Build lists of links (bullets, teasers or entire pages).
Last reviewed: April 14, 2021
This feature works comparably in both the Classic and Flex UI versions of the UBCMS. In the future, screenshots and language will be updated to reflect Flex UI.
Add the component to the page. You will initially see only the List tab. A second tab with corresponding settings appears after the Build list using option is chosen.
Lists with more than 500 teasers will generate a server error and not show any results. More details in this Known Issue: Page editing slow / lists break when too many components are included.
In lists, teaser thumbnails are square to better support all image shapes. When present, the teaser will preferentially use an image in set in the Page Properties (see Page Properties: Image tab). Consider adding a customized image there in addition to what is on your page, or recrop what you have previously loaded there to work better as a square thumbnail.
Tip: Learn how to make a quick link to the top of your page.
Here you will choose the type of list, as well as additional advanced settings.
Build list using: This drop-down menu asks how you want to build your list. You have the option to build it using:
Be careful not to list the parent page here by mistake--it can create a loop.
> read more in this Known Issue: Do Not Link to a Child's Parent Page in a List
Do not link to DAM assets using a relative path (/content/dam/...). For these you must use a File Download component. > read more about this Known Issue: Having Trouble Linking Downloadable Files in the DAM
New window: Select so each clicked page is displayed in a new browser window.
'Open links in new window' and 'Display as: Full content' are incompatible and will disable each other when selected.
When New Window is selected, an additional icon will follow the linked text, to alert visitors that they will be taken to a new browser window, or even leave the current website.
And if the hyperlink goes to a downloadable file, an document icon will instead be shown as well as the file size if the file is on the same server. (Read more about link labels.)
Display as: This drop-down menu asks how you would like your list to be displayed. Lists fall into the general categories of Links, Teasers and Content:
'Display as: Full content' and 'Open links in new window' are incompatible and will disable each other when selected.
Order by: Here are some of the ways in which you can order your list. Not all appear in the dropdown. Others may be available on request -- contact the DCT Help Team for details.
Reverse order - Check the box to select whether you would like to inverse the order selected in the Order by field.
Start at: Select how many items you would like to skip at the beginning of the list (example: '5' will skip the first four items and begin the list at the fifth item). Left blank, the default value of '1' will result in the list displaying every item in your list. This setting can be useful if you wish to feature several items in one group, perhaps at the top of your news page, or on your homepage, and NOT have them repeated with the rest of your list displayed elsewhere on your site.
Limit: Choose a maximum number of entries (optional).
If you want all items to appear in the list, do not leave the Limit field blank. Instead, enter a value that you anticipate will meet your needs; for example, 200, 500, etc. (The News Center has used 9999 as a 'very large number' because their archives date to 1990.)
Limit by Date - Limit list to content posted within this many years; leave blank to see all results.
Mobile limit - Maximum number of items to be displayed on a small screen device.
Paginate after - This setting turns on paginated returns, with the maximum number chosen displayed for each page (optional).
Previous page link label - Specify the link label -- 'Previous' by default.
Next page link label - Specify the link label -- 'Next' by default.
Display in Columns - Allows the list to be split into more than one column.
Exclude current page - Do not display any entries that link to the page on which the list is shown (optional).
Enable Scheduling: Select to enable shared content Scheduling.
If you use another site's page as a host page, your list will be indexed with that other site's pages, and appear in tehri search reults.
Empty message - Choose a suitable message that will display if the list is currently empty. (In the example shown above, it will say "Sorry, there is no news today.")
To override the default and use custom text in your teaser:
To override the default and use a custom image in your teaser:
Click OK. The first image on the page will no longer be displayed in your teaser. Instead, the image you selected will appear.
Any list can be used to build an RSS feed so people can pull your content into their own website.