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.
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.
List Paragraph varieties
List Paragraphs come in a few different flavors to support site-building needs.
- 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
- 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
- Display options: displayed in a grid format.
- Sort: People are sorted alphabetically.
- See people list examples
- Display options Publications can be displayed in either APA or Chicago citation styles.
- Sort: Publications are sorted by publication date
- See publication list examples
- Display options: Course lists can be displayed in a card or list format
- See course list examples
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:
- Open the Style/Behaviors, found at the bottom of the edit form.
- Check Hide if empty.
Display an empty list message
Here's how to display an empty list message:
- Select Style/Behaviors, found at the bottom of the edit form.
- 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.
News lists can be displayed as cards or lists
People lists are displayed as a grid.
- Senior User Experience Designer, Creative Lead
- Senior Web Project Manager
- Manager, Development Operations
- Customer Experience Specialist and Web Project Coordinator
- Front End Web Developer
- Senior Web Project Manager
Publications can be displayed with the APA or Chicago list styles.
Courses can be displayed in both list and card formats.
Students will engage in a variety of cardiovascular exercises that will improve overall performance in sports and leisure activities. This course will utilize class discussions, assignments and student participation to enable students to: (1) Understand the health and skill-related components of sports and physical fitness such as: cardiorespiratory endurance, speed ...
- Lillie, T.
Learn and practice methods and techniques to improve body mechanics, stability, and overall core (abdominals, lower back and pelvis) strength. A strong torso is an essential component in posture, performance (sports, leisure activities, or hobbies), and activities of daily living. Students will engage in variety of upper-body, lower-body and core ...
- Natsuki, M.
Students will be introduced to full-body conditioning training that targets the health-related components of physical fitness including: cardiorespiratory endurance, muscular strength, muscular endurance, and flexibility. A variety of mode of exercises such as weight training, core training, TRX, aqua jogging, and cycling will be incorporated in this course. Students will ...
- Lillie, T.