How Do I Work with Listing Pages?

Navigate to our DX Training Video guide for further visual guidance.

Purpose

The Listing Page allows you to create dynamic pages showcasing various content types in a list format. It simplifies the management and presentation of large amounts of similar content.

When to Use

This is ideal for situations where you need to display collections of content:

  • News & Events: Create a "Newsroom" page listing all your news articles.
  • Team Bios: Build a "People" page showcasing team member profiles.
  • Training Materials: List all training materials or resources.
  • Location Listings: Display a directory of your business locations.
  • Custom Content Types: Utilize Listing Pages for any content type that benefits from a list format.

Elements of Listing Pages

  • Content Source: Define the type of content you want to display in the list (e.g., "Basic Pages," "News," "Events").
  • Automatic List Field: This field dynamically populates the list based on your chosen content type.
  • Items per Page: Control the number of items displayed on each page of the list.
  • Filters: Optionally enable filters to allow users to refine the list based on specific criteria (e.g., category, tags).
  • Topic Targeting: Restrict the list to content assigned to a specific topic within your taxonomy.
example of list illustration freepik
Image by storyset on Freepik

Listing Pages Best Practices

The Listing Page allows editors to collect "buckets" of content together into one long list. These might be used, for example, for a "News Feed" or "Newsroom" page of all past news items, or a long list of all Basic Pages assigned to a specific Topic.

For example, the Training Playlist is a "listing page" of all basic pages, with the topic of "Training."

Options for your Listing Page include:

  • Type of Content: such as How Do I, News, Basic Pages, Locations, Contacts, Documents
  • Display as: such as a Teaser or set of Linked Titles
  • Items per page: How many items do you want to display on the listing page
  • Include filters: Filters appear at the top of the list and allow for additional filtering of content produced in the listing page
  • Sort Alphabetically: Choose "True" for an alphabetized list
  • Show only Topic: Constrain results to one "Topic" pulled from your "Topics" taxonomy list

Here are some variations:

Listing Page of Linked Titles, showing only one topic:

Listing Page of Titles

Listing Page of Linked Teasers, showing only one topic:

Listing Page of Teasers

Listing Page of Teasers filtered by Title:

Listing Page of Teasers filtered by Title

Listing Page of Teasers filtered by Title and Topic:

Listing Page of Teasers filtered by Title and Topic


We recommend you build a Listing Page of all Basic Pages, and use that as a base to test options.

1

Log in to your site

Everyone who writes things on this website has a special title. These titles give them certain abilities, like who can edit, review and publish what. You can ask for a different title or take one away from someone using the user manager.

Login using login.iowa.gov
2

Navigate to the Content tab

You can add pages to your website by navigating to the content button but make sure you are logged in so that you can have access to that tab.

decorative

You can sort the pages that you've created using the filter button as well as edit the pages you've created for your website by selecting the edit button within the content list page:

(Example of Content list page)

decorative
3

Create a Listing Page

Create a new Listing Page by navigating to Content within the navigation bar, from their select add content, then lastly select listing page:

example of how to add a listing page

Options for creating a listing page include:

  • Listing page of "Basic Pages" to collect and display basic pages.
  • Listing page of "How Do I" to collect and display how do I content.
  • Listing page of "Events" to collect and display events.
  • Listing page of "News" to collect and display events.
  • Listing page of "Locations" to collect and display locations.
  • Listing page of "Contacts" to collect and display contacts.

If you want to be more specific you can choose to only show certain types of things within your chosen category such as Topics or "types" like Event Type, or Contact Type, or Location Type.

Editing, Publishing, Scheduling Content

Authors will have the ability to edit content based on different privileges.

Here is a table that demonstrates what each author type or content managers can do:

User Roles and Permissions
 WriterEditorPublisherAgency Manager
Create this contentXXXX
Edit own contentXXXX
Edit anyone's content XXX
Publish this content  XX
Unpublish this content  XX
Delete own content    
Delete anyone's content    
Schedule this content  XX
4

Editing, Publishing, Scheduling Content

Authors will have the ability to edit content based on different privileges.

Here is a table that demonstrates what each author type or content managers can do:

User Roles and Permissions
 WriterEditorPublisherAgency Manager
Create this contentXXXX
Edit own contentXXXX
Edit anyone's content XXX
Publish this content  XX
Unpublish this content  XX
Delete own content    
Delete anyone's content    
Schedule this content  XX
5

Confirm your knowledge

If you need visual guidance that shows the step-by-step process of creating things for your website make sure to go to our Video Training Page!

Content Manager Website Creation Playlist