The Lists Paragraph provides the ability to dynamically generate a list of Events, News, People, or Publications to display throughout your site.
Lists can be displayed in a card or list format for News and Events, and as a grid for People. Publications can be displayed in either APA or Chicago citation styles. Lists can be adjusted to display a specific numbers of items, and specific lists can be created based on taxonomy terms.
The Lists paragraph is made up of four parts:
- List Format: In the List Format section, you have the ability to choose your desired content (Events, News, or People), and the display format. Available advanced options also allow for you to customize your list based on taxonomy terms, as well as override the default number of items displayed.
- Headline: Optional headline that will appear above the list items in large font.
- Description: Optional description that will appear below the headline and above the list items.
- Button URL and Link Text: Optional button that is displayed underneath the list items.
Lists of Events and News can be displayed in a card and list format, and People can be displayed in a grid format. Publications can be displayed in either APA or Chicago citation styles. By default, the card format displays 3 cards, while the list and grid format will display all the items by default.
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
By default, Event and News Lists will display your most recent item, while People will be shown alphabetically. If you would like to customize which Events, News, People, or Publications appear in a list, you can create a custom list based on your Events, News, Person, and Publication taxonomy terms. To do this, enter your term(s) in the Advanced Options field Arguments. Keep in mind that terms with spaces in them will most likely include a hyphen (e.g. the term for “In the News” would be “in-the-news”).
Managing the number of items in your list
By default, the cards format displays 3 items, while the list and grid format will display all the items by default. If you would like 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.
News List displayed in "List" format with optional headline, description, and button:
News List with "Cards" display:
Events List with "Cards" display:
Events List with "List" display, and number of items set to 2:
Publications List with APA styles:
Publications List with Chicago styles:
People List with number of items set to 3:
List Paragraph with multiple items in a row:
Lists can also display differently when sharing a row with other paragraphs. For example, the News List below stacks vertically when sharing a row with another paragraph, in this case a Text Area.
Vertical Events List with "Cards" display:
Vertical Events List with "List" display, and number of items set to 2:
Vertical People List: