Pagelists & Tags

A pagelist is essentially a curated selection of pages that are rendered using a shared template. Each page in the selection is iterated and displayed in a consistent way, which makes pagelists suitable for many common use cases. They can power a simple navigation, but they work just as well for more visual layouts, such as a portfolio grid or blog where each entry shows a preview, title, or other page-specific information.

Building Relations With Tags

Tags provide a powerful way to enhance visitor experience and improve content discoverability by creating connections between pages. Tags label pages by topic, and pagelists can consume these labels to display related content — such as a "Related Pages" section below a blog post. They can also be used as filters for a pagelist in a larger blog or product collection page, for example. To tag a page, open the Settings tab while editing the page and add the tags to the Tags field. Separate multiple tags with a comma or a tab.

Pagelist Blocks

Pagelists are not tied to a specific location or layout. They can be created and placed anywhere as blocks inside a block editor. To add one, click the small + icon in the editor and search for Pagelist. Once the block is inserted, a template can be selected and the page selection can be configured. This allows full control over which pages are included and how they are rendered, without leaving the editor.

A pagelist block has the following settings:

SettingDescription
Template fileThe template that renders each page of the list. Next to the built-in Default template, you can select any pagelist template of the installed themes. See Pagelist Templates below.
Exclude hidden pagesLeaves out pages that are hidden in the navigation. This option is enabled by default.
Exclude this pageLeaves out the page that contains the pagelist.
Sort byThe field that is used for sorting, for example :index for the order of the pages in the dashboard, date or title.
Sort orderAscending or descending.
TypeThe pages that are included in the list:
all — all pages of the site
children — the subpages of the page selected as Parent page
related — pages that share at least one tag with the current page
siblings — pages that have the same parent as the current page
Parent pageThe page whose subpages are listed when the type is children. When the field is empty, the current page is used.
Filter by tagOnly includes pages that have the selected tag.
Offset / LimitThe offset skips the given number of pages at the beginning of the list. The limit sets the maximum number of pages that are displayed and defaults to 10.
Filter by URL (Regex)Only includes pages whose URL matches the given regular expression, for example ^/blog/.
Filter by template (Regex)Only includes pages whose template matches the given regular expression.

Pagelist Templates

The look of a pagelist block is defined by the template that is selected in its Template file setting. Themes can provide their own pagelist templates that take care of layout details such as spacing, alignment and width. The Standard Lite theme that ships with Automad includes the pagelist templates Blog Grid, Grid Image Top, List and Masonry.

In addition, Standard Lite has two page templates with a built-in main pagelist: Pagelist Full Width Centered and Pagelist Full Width Left. They render a pagelist below the page content, together with a filter menu that lets visitors filter the list by tag. This filter menu is only part of these page templates and is not available in pagelist blocks. You can configure the main pagelist in the Settings tab of the page, using the fields that start with Main pagelist, such as the layout, the sorting and the maximum number of items per page.

Files Open Graph & Favicons