Display a list of news story headlines (for narrow columns).
Last reviewed: May 24, 2022
This component initially has two tabs: News List Module and List. An additional tab appears after the Build list using option is chosen.
Note: this component is essentially a List Builder, without the 'Display as' settings.
Split long lists onto several pages.
Lists with more than 500 teasers will generate a server error and not show any results. More details are in this Known Issue.
Click the wrench icon to 'configure' these settings.
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:
Host Page: (where applicable) Set the preferred page to display your list items. If blank, the current page will be used.
New window: Select so each clicked page is displayed in a new browser window. When selected, an additional icon will follow the linked text on your published page, to alert visitors they are about to be taken to a new browser tab, and possibly leave the current website.
Note: For accessibility reasons, be careful about sending your visitor to a new tab. This behavior may be unexpected and disorienting. (> Learn more about link accessibility.)
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.
Using server caching, 'random' content is shuffled to appear fresh for each visitor, but the entire original content collection is not redrawn each time it is presented. Instead, the server randomly pulls a sample of the original content after each cache refresh, and then shuffles that sample for your visitors. If you need to show the entire collection, take advantage of the 'show all' feature when it is available, and if your business needs require a truly random reassortment, please contact the DCT Help Team.
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.)
To avoid confusion, every unique link on a page must have unique link text. It is not hard to compose comprehensive text for manually coded links, but links that are generated automatically by lists and carousels must also be different, which takes more planning.
Also consider Call to Action, Button, and Tabs components, as well as the pagination and "see all" links in the Event and News List components which may have the same labels and appear more than once on a page. (Some of these have additional label settings that can help prevent this redundancy.)
Best practice: when creating shared content pages that will be used in lists, use distinct titles, or set the Navigation Title in the page Properties so none of your pages have the same title if they are displayed together. Also take advantage of additional label settings in other components when you will have several on a page.
Link text should describe where the link will take the user in a manner that is appropriate to the context on your page and also the target page. This is also true for images that act as links.
Best practice: Avoid meaningless standalone phrases like "click here", "see all" and "learn more".
Links in many components can be set to open in a new browser window (or tab). The user can thus explore the new page, while preserving the source page (and your website) in the original tab. However, this can be confusing if the user does not realize a new tab has opened. They may become lost, confused how they arrived on that new page and unable to return to your site.
Best practice: let the user control their experience and stay in the same tab, with two notable exceptions:
These tips should apply to all UBCMS components that provide a 'build by search' option (e.g. List Builder, News List, Event List, Full Width Carousel and the Horizontal and Vertical Slide Decks).
Please note, special characters (e.g. "&", "|", "-") are not permitted in a search query and are automatically removed.
You can also use the search option to list tagged pages. And the above logical operators allow fairly advanced logic for tagged pages that is not possible using other tools.
The following is a live example of a News List: