Skip to main content

An official website of the State of Maryland.

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

Listing Page

How to use a Listing Page

A listing page is a standalone page that automatically displays a dynamic list of content, such as news, contacts, locations, events, or documents. Listing pages help organize content and allow visitors to search and filter results to quickly find the information they need. 

Within each list, the content can be selected and filtered based on criteria like content type, topic, and a variety of other taxonomy vocabularies.

Watch: How to Create a Listing Page

Learn how to use a Listing Page on your website.

Examples Listing Pages:

Required fields

1. Title - 75 characters max

2. Summary - 160 characters max

Brief description of the content of the page (also known as meta description). Appears in search engine results and in social media shares.

3. Listing content

Choose the type of content you want to display, such as:

  • News
  • Contacts
  • Locations
  • Documents
  • Events

Depending on which content type you chose, additional options will appear. Here you can select

  • Which filters visitors can use
  • How many items display per page
  • How the results are displayed such as:
    • Alphabetically
    • Latest date
  • Limit results by taxonomy terms such as:
    • Topic
    • County

Optional fields

1. Short title

Use the Short Title when the Title is approximately 75 characters and you’d like a shorter label to show in the breadcrumbs and side navigation menus.

2. Featured image

Featured Image can be included at the top of the page. 

  • The image should be meaningful.
  • Don’t use logos, branding, or images with overlaid text.
  • The image size is 298x397 pixels (3:4 aspect ratio).

3. Description - 250 characters max

The Description appears at the top of the page underneath the Page Title. The Description provides context to the Listing Page.

4. Taxonomy terms

Listing pages can be categorized using taxonomy terms  to help classify and organize this page, including up to five topic terms, a division or section, and agency specific terms.

5. Body text - unlimited characters

You can add formatting to the body text.

When to use a Listing Page vs. Automatic List

Listing Page

  • A Listing Page is a full standalone page
  • Displays a dynamic list of content
  • Includes filtering and search tools

Automatic List

  • An Automatic List is a  smaller micro-content component
  • Embedded inside another page (such as a landing page)

Get support

Ask questions about the Maryland Drupal CMS, Maryland Web Design System (MDWDS), accessibility, plain language, and more.

Get support