Listing Page

When to use a Listing Page

A Listing Page can be used when you want to create lists of certain content. You can use Listing Pages to build pages of Bios, Contacts, Events, Locations, and much more.

Listing Pages are created three different ways:

    • Automatic lists - Lists are created based on certain criteria and will automatically update as soon as new content is added that meets the pre-defined criteria. Automatic lists can pull from the following content types:
      • Bios
      • Contact Directory (with or without the "division" taxonomy included)
      • Events
      • News
      • Press Releases
      • Documents (displayed as a list or as a Data Table)
      • Topic Pages
    • Curated lists - Lists are manually built and sorted by a content manager.  You can narrow your list to certain content types, or make a list of a mix of content types.
    • External lists (uncommon) - Lists are created by embedding external content that will display as a list, like data from a Knack or Quickbase application. 

Similar Content

Listing pages behave much like the microcontent type Link Collection.  The primary difference is that Listing Pages are standalone pages, which can be accessed via URL.  Link Collections are microcontent, embedded within other pages.

How this content type interacts with other system components

InteractionsSystem Component
This content type can be involved in the following Taxonomies

Division/Section

Program/Service

Category

How to create a Listing Page

Listing Pages are very powerful! We encourage you to come to Advanced Training Class to see examples of complex Listing Pages. Also, you are welcome to open a Support Ticket to discuss how a Listing Page may address your unique content needs.

  • Log into your agency website.
  • Click on Add Content.
  • Select Listing Page.
  • Add Title (required).
    • The Title appears at the top of the page, and is also used in URLs and anywhere the page is linked to from other content across the site.
  • Add Short Title (optional).
    • The Short Title, if used, will replace the title in URLs and anywhere the page is linked to from other content across the site.
      • Note: The Short Title will NOT replace the Title at the top of the page
  • Add Summary (optional).
    • Add a short statement to summarize the page’s content or purpose. This will show on the page above the list that you create.
  • Choose the List Behavior (required).
    • This will determine how your list is built.

Curated List

  • Select Curated if you want to select specific content to appear on the page and how it is sorted.
  • In the Curated List box, first select the List Type (required) - Choose what type of list you want to build based on the content type.
    • Bio (to list only bio pages)
    • Link Collection (to create a mixed-type list of any content type)
    • Program or Service (to list only program/service pages)
    • Document (to list only documents)
  • Select the Design Treatment for that list (required) - This is how your list will visually display to users.
    • The Design Treatments available depend on the type of list you're creating. For example, for lists of Bios, There are three options:
      • List of teasers - This will display a block of information from the content you selected with an image.
      • List of teasers (no image) - This option will non include the image from the Bio.
      • List of links - This will display the title of each piece of content you select, linked to that content's page.
  • Select the List Items (optional) - Based on the List Type you selected above, here is where you will choose which pieces of content get added to your page.
    • For List Types other than Link Collection: Choose the Add [Content Type] button.
      • When the dialog box appears, select each piece of content that you want to include. 
      • Once you’ve selected your content, hit the Select button at the bottom of the screen.
      • All of the content you selected will appear in the List Items box.
      • If you want to delete a piece of content from your list, click the Remove button below it. 
      • Drag and drop items to rearrange the sort order. 
    • For Link Collection List Types:
      • Click Add Link Collection
      • If you want to create a new Link Collection, fill in the form, per the instructions from the Link Collection Training.
      • If your Link Collection is already created, select Link Collection Library at the top of the window. Find the Link Collection you want to add, and click the Select button at the bottom of the screen.
  • Publish, Save as Draft, or Schedule Publishing for your Listing Page (see Publishing instructions for more information).

Automatic List

  • Select Automatic if you want the system to determine how your list is built. Any time content is added based on the pre-defined criteria, it will automatically update this list.
    • An Automatic list can create lists of the following, by selecting its corresponding List Type:
      • Bio
      • *Contact Directory - see below for details
      • Events
      • News
      • Press Releases
      • Topic Page
      • Documents
    • The Display as field determines how it is viewed on your site when rendering results of the list. Your display choices (for most content types) are:
      • Linked Title
      • Teaser
  • Enter Items per block (required) - Enter the number of items from this list you want to display on a single page. 
  • Check Show Pager (optional) - If your list is going to be very long (more items than you selected for your 'items per block', you should check the Show Pager box. This will add page numbers to the bottom of the page for users to click through multiple pages of the list.
  • Enabled filters (vary per list type):
    • Title (optional) - This is a Title filter that will be added to the top of the page if checked. Users will be able to search the Listing Page by Title.
    • Type (optional) - For certain list types, users can select from your Type Taxonomy to filter the list.
    • News Type & Topics (optional) - These filters are only available when List Type is News.
    • Name (optional) - This filter is only available when List Type is Documents. 
  • Select the Type of content you want to display (optional & dependent upon List Type) -
    • Bio type allows you to display your Listing Page for different types of content. For example, if you have 2 Types of Bios (Staff and Board Members), you could choose bio_type: Staff to only show a list of Staff Members on this page.
    • Event type allows you to select a subset of all events on your site for display. For example, if you have 2 types of Events (Board Meetings and Conferences), you could choose event_type: Conferences to limit your list to Conferences only.
    • News type, like Event and Bio types, allows you to segment your list to a subset of your News content based on taxonomy.
    • Document type allows you to segment your list to show only documents tagged with a specific document_type taxonomy term.

Note: Contact Directories are pre-designed tables to display contacts with their associated role, email, phone number and notes. If any of these fields are blank for all entries, the column will not display.

  • To create a Contact Directory:
    • Select Contact Directory from the Automatic List Type selection
    • Enter Items per block (required) - Enter the number of items from this list you want to display in the directory table
    • Select Contact Type to include in the directory
    • Notes label override: Enter the term you would like to appear at the top of the Notes column; this column will display any content entered in the "notes" field when the contact was created.
    • You can further segment your list by selecting the Program or Service for which you want to create the directory. This will show content which as been associated with the selected Program or Service when the contact was created.
  • Publish, Save as Draft, or Schedule Publishing for your Listing Page (see Publishing instructions for more information).

External List

  • Select External to create a list built from external content, like Knack or Quickbase.
  • In the External List box, select the Provider (required) for your external list. This can be either:
    • Knack
    • Quickbase
  • Select either Knack or Quickbase. You can create something new by clicking Create Knack or Create Quickbase.
  • Add a Title (required) - This will be the Title of your list.
  • Add the URL (required) - Whether you chose Knack Embed or Quickbase, input the correct URL for your list.
    • Note: Use the help text under the URL field to help with the formatting of your URL.
  • Click Save.
  • Publish, Save as Draft, or Schedule Publishing for your Listing Page (see Publishing instructions for more information).

Remove a Listing page

To remove a Listing Page from your site, either Unpublish the page, or move it to the Trash.