Lists Paragraph

The Lists Paragraph provides the ability to dynamically generate a list of Events, News, People, Basic Pages, Courses or Publications to display on a page.

List Paragraphs are powerful site-building tools. They offer a variety of display and sorting options based on the types of content in the list and can be adjusted to display a specific number of items and/or dynamically generated based on taxonomy terms.

View list examples

The Lists paragraph is made of these parts:

• List Format: This section offers a View list to choose a content type (Events, News, People, etc.) and Display format.
• Advanced options: This setting can customize a list based on taxonomy terms, as well as override the default number of items displayed.
• Headline: The headline displays as a heading above the list.
• Description: The description text displays below the headline and above the list.
• Button: The button displays a button-styled link below the list.
• Style/Behaviors: Provides options for handling empty lists.

Note: see Comparing Teaser and Lists for potential use cases for Lists and a comparison between Lists and the Teaser Paragraph.

List Paragraph varieties

List Paragraphs come in a few different flavors to support site-building needs.

Event Lists

• Display options: Can be displayed in a card, list, or past events list format.
• Sort: Sorted by date.
• Filtering: Card and list formats will always show upcoming events first. Events that have already occurred will fall off the list. Past events list will show all events that have already occurred.
• See event list examples

News Lists

• Display options: can be displayed in a card or list format. 
• Sort: Most recent news always appears at the top of the list.
• See news list examples

People Lists

• Display options: displayed in a grid format. 
• Sort: People are sorted alphabetically.
• See people list examples

Publication Lists

• Display options Publications can be displayed in either APA or Chicago citation styles. 
• Sort: Publications are sorted by publication date
• See publication list examples

Course lists

• Display options: Course lists can be displayed in a card or list format
• See course list examples

Advanced options

By utilizing the advanced option settings for these displays, you can customize your list by taxonomy terms, or change the default number of items displayed in your list.

Creating a custom list with taxonomy terms

If you would like to customize which items appear in a list, create a custom list based on your taxonomy terms. This requires that you have already tagged content with these terms.

Enter your taxonomy term(s) in the Advanced Options field called Arguments. Convert all spaces to a hyphen (e.g. the term for “In the News” would be “in-the-news.”)

Managing the number of items on your list

To override the default number of list items displayed, simply enter your desired number of items in the Advanced Options field Number of items. This also disables the pager if one is configured for this display. 

Managing empty lists

If no items meet the list criteria and the list is empty, Site managers can choose to either hide the list paragraph or display an empty list message. If a new item becomes available later that does meet the criteria, the Lists Paragraph will reappear on the page. 

Hide the List Paragraph

Here's how to hide the empty list paragraph:

1. Open the Style/Behaviors, found at the bottom of the edit form.
2. Check Hide if empty.

Display an empty list message

Here's how to display an empty list message:

1. Select Style/Behaviors, found at the bottom of the edit form.
2. Type your message in the Empty list message text box.

Lists Paragraphs in a column

Lists can display differently when sharing a space with other paragraphs. For example, the News List below stacks vertically when a Section Layout with another paragraph, in this case, a Text Area.

List paragraph examples

You can choose between card and list displays for most content types. 

Events

Upcoming or past events can be displayed as cards or lists.

News examples

News lists can be displayed as cards or lists

People Examples

People lists are displayed as a grid.

Publication examples

Publications can be displayed with the APA or Chicago list styles.

Course example

Courses can be displayed in both list and card formats.