The Page List block displays a list of all published pages on your site.
In this guide
You can use the Page List block to automatically compile and display a hierarchical list of links to all published pages on your site.
Most commonly, you will encounter this block in your site’s navigation menu. When you first add a Navigation block, the Page List block is automatically included within your menu.
The Page List block is automatically added for you when you add a Navigation block to use as your website’s menu.
If you want to add the Page List block elsewhere, click the + Block Inserter icon and search for “page list”. Click to add the block to a page, post, or template.
💡
Using your keyboard, you can also type
/pageon a new line and press enter to quickly add a new Page List block.
Check out our detailed instructions on how to add content using blocks.
Once the Page List block is added to a post or page, the block will automatically display the list of all published pages on your site like this:
If your pages do not appear, ensure your pages are set to public and not private, draft, or scheduled. Only publicly accessible pages will be shown.
The Page List block respects page hierarchy by default, which means that if a page was originally added as a child page, it will be indented below the parent page. For more, see our guide on page attributes.
When you click on the block, a toolbar of options will appear above or below it:
The Page List block offers the following options in the toolbar:
- Change block type
- Drag block to change its position on the page/post
- Move block up or down
- More options
When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:
If you only want to show certain pages in the Page List block instead of all published pages on your site, you can select a parent page to display only the child pages for that particular page. The parent page will not be displayed either. See our guide on page attributes to learn how to set up parent and child pages.
For more, visit our detailed instructions on Advanced settings.
In the block settings sidebar, click on the Styles icon to access the design settings for the block. The Styles icon is in the shape of a circle with half of the circle filled in:
For more, visit our detailed instructions on Typography settings.
