A List Page collects all items of a specific content type, typically in chronological order. For example, a News Content Type List Page displays a list of all News items – see https://sitespro.duke.edu/news.

Image
Sites@Duke Pro webpage titled News, displaying a filterable list of News items

Available List Pages

Once activated by an admin user, these pages are generated automatically by Sites Pro and are viewable only on your front-end production website.

The following content types have associated list pages available:

Content TypeDefault Page TitleDefault URL
Blog Post   Blog /blog
Event

Events

Past Events

/events

/past-events

NewsNews/news
ProfileStaff/staff
ProjectsProjects/projects
ResourceResources/resources
Scholars Profile

Faculty

Students

/faculty

/students 

StoryStories/stories

 

Set up Your List Pages

Activate a list page

Content type list pages are turned off by default on all new sites (as of January 2023).

Only activate List Pages if you will be using the corresponding Content Type, because empty list pages may negatively affect your search engine rankings. For example, activate the News List Page if you have News items on your site, but leave it deactivated if you are not using News.

Image
Checkbox labeled "Activate Blog List Page" under the Customize List Page header

1. In the Drupal admin menu, go to Structure Site Information.

2. Click Customize List Pages to reveal a list of all available List Pages on the site.

3. Enable the desired List Page(s) by checking its "Activate" checkbox.

4. Scroll to the bottom and click Save.

Customizing list pages

Site Admin users have the ability to customize the Page Title and URL alias of List Pages. For example, you can change the “Staff” page (/staff) to “Team” (/team). However, you cannot change which content types appear on the page.

1. In the Drupal admin menu, go to Structure Site Information. 

2. Click Customize List Pages.

Image
Sites Pro admin interface to customize list pages – a URL Alias field, followed by a Title field

3. URL Alias: Use only lowercase letters (a-z), numbers, and hyphens. For example, changing the URL Alias from Resources to "resource-library" will create a list page with the URL yoursite.duke.edu/resource-library.

4. Title: This is the page title at the top of the List Page.

5. Scroll to the bottom and save. 

IMPORTANT: Customizing a URL will break links to your list page

When you change the URL Alias of a List Page, any previously-created links pointing to that page will NOT automatically update or redirect to the new URL. You will need to do one of two things:

  1. Update any links to that page to point to the new URL.
  2. Add a redirect.

Linking to List Pages

  • Link to List Pages within your site: Simply enter the appropriate URL path (e.g., /news) when you add links within your own site.
  • Link to List Pages from an external site: Each List Page URL is comprised of your site's URL, followed by its URL Alias. For example, the default URL of the Blog List Page would be https://yoursite.duke.edu/blog.

Filtering

Image
Checkboxes to filter a page of News items by either Category terms or Date

List pages may include 1-2 filters (e.g., checkboxes allowing you to filter all News items by Category).

These filters use AND logic, not OR logic – so, selecting multiple filters will only display results that meet all chosen criteria. For example, filtering the News List Page by Category "policy" and Date "March 2022" will only list News articles that are tagged with "policy" and published in March 2022. The results list will get shorter as more filters are selected.