Paragraph Reference Block: Listings

Use this paragraph Block to display the links from a dynamic Listing node, add your own list of links, or add a list of files to the node.

CMS Support

March 16, 2023

On this page:

Dynamic Listing Paragraphs

Static Listing Paragraphs

File Listing Paragraphs

Coming soon: Card listing Paragraphs

Examples

 

Use this paragraph to display the links from a dynamic Listing node, add your own list of page links, or add a list of files to the node.  

Listing screenshot paragraph reference

How to Add a Dynamic Listing Paragraph Reference:

Dynamic listing paragraphs pull automatically from a singular listing node. That Listing will pull content based on taxonomy, such as office specific topic, keyword, or topic. 

Dynamic listing paragraphs are useful when you have a list to which you anticipate adding new content on a regular basis. Click here for more information about Listing nodes.  

STEPS:

  1. Select Add Paragraph Reference in Layout Builder, 
  2. (optional) Enter any Block Heading as desired. 
    1. (Click here for more information about Block heading options)
  3. Select Add Listing from the Configure Block page, 
  4. Select ‘A Dynamic Listing Node' for Listing Type.
  5. Select a Listing node from the Listing field search. The selected Listing node will be the node from which the Dynamic Listing Paragraph will pull content. You may search for your desired Listing using the title or node ID of the Listing node. 
  6. Select the Orientation. The direction the content is listed. Vertical lists default into two columns at wider screens, while horizontal lists will be scrollable. The Grid format (only available on Homepages) will display items in boxes side by side.
  7. Select the Display Format. This will determine how the embedded content in the Listing displays. This may radically change if the paragraph's orientation is changed.
  8. (optional) Select the Layout Style if desired. 
    1. (Click here for more information about Layout options)
  9. Select ‘Add Block’ to finish adding the Paragraph. 

Note about Unpublished content

Unpublished and Draft content is unable to be referenced in a Static Listing, to prevent broken links from being published in the site.

How to Add a Static Listing Paragraph Reference:

Static listings might contain content that is not all of the same content type. For example, you may want to populate a list with external resources, people, articles, or other content types. Static listings enable you to manually populate and configure the order of the items that appear in your list. 

STEPS:

  1. Select Add Paragraph Reference in the Layout Builder section, 
  2. (optional) Enter any Block Heading as desired. 
    1. (Click here for more information about Block heading options)
  3. Select Add Listing in the Configure Block page, 
  4. Select ‘A Static List‘ Type. 
  5. Select the Orientation. The direction the content is listed. Vertical lists default into two columns at wider screens, while horizontal lists will be scrollable. The grid format (only available on Homepages) will display items in boxes side by side. 
  6. Select the Display Format. This will determine how the embedded content in the Listing displays. This may radically change if the paragraph's orientation is changed.
  7. Select the Entity Type. 
  8. Select a Node to add to your List from the Items Field
    1. Add additional Items by selecting ‘Add Another Item’ as desired. 
    2. You may configure the order of the added items by dragging and dropping them into the desired location. You may also select 'Show row weights' from the upper right hand corner to manually configure the order in which the items will appear in the Listing Paragraph. 
  9. Add Media as desired.
  10. (optional) Select the Layout Style if desired. 
    1. (Click here for more information about Layout options)
  11. Select ‘Add Block’ to finish adding the Paragraph. 

How to Add a File Listing Paragraph Reference:

File listings may be used to display a list of linked document media on your page. 

STEPS:

  1. Select Add Paragraph Reference in the Layout Builder section, 
  2. (optional) Enter any Block Heading as desired. 
    1. (Click here for more information about Block heading options)
  3. Select Add Listing in the Configure Block page, 
  4. Select ‘A File Listing‘ Type. This type of listing can be used to add external files in a horizontal list format. 
  5. Select the Display Format. Display format will determine how the embedded content displays in the Listing. This may radically change if the paragraph's orientation is changed.
  6. Add listing items by selecting 'Add Media' as desired. 
  7. (optional) Select the Layout Style if desired. 
    1. (Click here for more information about Layout options)
  8. Select ‘Add Block’ to finish adding the Paragraph. 

See Examples of the Listing Paragraph (there's a lot of options!)

Any Questions, Comments, or Requests?

Contact us at [email protected]