Skip to main content Skip to secondary navigation

Lists Paragraph

Main content start

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.


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

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

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.


News list

You can filter using taxonomy terms and set the number of items to display.

This is a text area

This demonstrates how you might put a text area in a two column section with a list paragraph type. 

Curabitur suscipit suscipit tellus. Cras ultricies mi eu turpis hendrerit fringilla. Nunc sed turpis. Phasellus magna. Phasellus blandit leo ut odio.

Maecenas ullamcorper, dui et placerat feugiat, eros pede varius nisi, condimentum viverra felis nunc et lorem. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Phasellus blandit leo ut odio. Sed libero. Pellentesque auctor neque nec urna.

Praesent egestas neque eu enim. Quisque ut nisi. Donec mi odio, faucibus at, scelerisque quis, convallis in, nisi. Nullam tincidunt adipiscing enim. Donec vitae orci sed dolor rutrum auctor.

Fusce pharetra convallis urna. Aenean massa. Nunc nulla. Proin pretium, leo ac pellentesque mollis, felis nunc ultrices eros, sed gravida augue augue mollis justo. Etiam vitae tortor.

Curabitur a felis in nunc fringilla tristique. Ut tincidunt tincidunt erat. Fusce egestas elit eget lorem. Aenean ut eros et nisl sagittis vestibulum. Donec id justo.

List paragraph examples

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


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

Upcoming events cards

Upcoming events list

Events are sorted by date

Past events

News examples

News lists can be displayed as cards or lists

News list

You can filter using taxonomy terms and set the number of items to display.

People grid

You can filter using taxonomy terms and set the number of items to display.

People Examples

People lists are displayed as a grid.

People grid single column

Here you see a grid of six people.

Publication examples

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

Publications APA list style

  • Last, F., & Company, . (2023). Other Publication Example. This Is the Subtitle. This is the publisher.
  • Last, F., & Company, . (2023). Thesis example publication [Type of dissertation, This is the publisher].
  • Diamond, L. . (2020). Ill Winds. Saving Democracy from Russian Rage, Chinese Ambition, and American Complacency. Penguin Random House.

Publications Chicago list style

  • Last, First, and Company. “Other Publication Example”. This is the publisher, January 1, 2023.
  • Last, First, and Company. “Thesis Example Publication”. Type of dissertation, This is the publisher, 2023.
  • Diamond, Larry. Ill Winds. Saving Democracy from Russian Rage, Chinese Ambition, and American Complacency. Penguin Random House, 2020.

Course example

Courses can be displayed in both list and card formats.

Courses List

You can tag and list selected courses.

  • PHYSWELL 8  | 2023-2024 Winter, Spring


    • Lillie, T.
    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 ...
  • PHYSWELL 7  | 2022-2023 Winter


    • Natsuki, M.
    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 ...
  • PHYSWELL 2  | 2023-2024 Winter, Spring


    • Lillie, T.
    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 ...

Course card list

Here's how the course cards display

Basic page list

Basic Pages Card Grid

No basic pages to display

Shared Tags Content

Using shared tags, you can display related content but different content types in the same section.

Related topics

Teaser Paragraph Icon

Teaser Paragraph

The Teaser Paragraph allows you to easily highlight other content from your site on a page


Taxonomy provide a way to group similar types of information together, which can be leveraged to categorize content and improve your site's flow.