Listing Page

How to use a Listing Page

A Listing Page highlights a list of similar pages, with optional search and filters. Listing Pages are often used for a newsroom, staff directory, event calendar and more.

• Choose from 8 different types of lists.
• Add basic details and customize the page using Page Components. All are available except Callout and Summary Box.
• Add search and filters to let visitors narrow down the results.

Listing Page Examples

• Contacts
• News
• Events
• Locations
• Basic Pages
• Images

Required fields

1. Title - 75 characters max

The Title appears at the top of every page. 

2. Summary - 160 characters max

The Summary (also called a meta description) provides a short description of the page for search results, social media, or assistive technology. The Summary does not appear on the page.

When creating a Summary, be concise and describe what visitors will find on the page.

3. Listing content

Select the type of Listing content to display on the page. Options include:

• Basic Pages
• Contacts
• Locations
• News
• Past Events
• Upcoming Events
• Documents
• Images

Optional fields

1. Short title - 100 characters max

Use the Short title when you’d like a shorter label to show in the breadcrumbs and side navigation menus.

2. 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.

3. Featured image

A Featured image can be included at the top of the page. 

• Use an image at least 1800px wide, with a 1:1 aspect ratio.
• The image should be meaningful.
• Don’t use logos, branding, or images with overlaid text.

5. Body - unlimited characters

Use the Body to add introductory information that shows above the list.

6. Items per page

Choose how many links that show on a single page of results. When you have more content than this number, pagination will show at the bottom of the list.

7. Include filters

Optionally include a search box and filters for visitors to browse the list of content. Your news, events, or other listing content must be categorized using Taxonomy tags for the filters to appear.

8. Sort alphabetically

Select Sort alphabetically to sort alphabetically rather than by date.

9. "No results" message

When a visitor searches or filters by categories that do not return any results, "Sorry, no matching results found." appears. Use this field to change the default message.

10. Show only...

Taxonomy tags can also be used to limit the list of what is shown to visitors. Use these fields to choose tag(s) to show a subset of news, events, or other listing content. 

Filters vs. "Show only..."

Customize a Listing Page to meet your agency's goals and needs of your visitors using filters, "Show only..." options and Taxnomy tags. 

• Filters give visitors the option to narrow what is shown on a Listing Page. 
• "Show only" gives site editors the option to narrow what is shown on a Listing Page.

Scenario: Calendar of events

An agency wants to build a calendar of upcoming events: workshops, conferences, and webinars. The agency has to decide whether to have a single page of events or dedicated pages for each type of event.

Before creating the Listing Pages, the agency categories all of the events using an Event type tag. Tags are managed using the Drupal Taxonomy page.

Option 1: A single page of events

To create a single page of events:

1. Create a "Event Calendar" Listing page.
2. Select Upcoming events from the Listing content drop-down menu.
3. Select the Event type checkbox under Include filters.
4. Save the page.

Option 2: Dedicated pages for each type of event

To create a page for each type of event:

1. Create a "Workshops" Listing page.
2. Select Upcoming events from the Listing content drop-down menu.
3. Select the Workshops from the Show only Event Type drop-down menu.
4. Save the page.
5. Repeat for Conferences and Webinars.