Skip to main content

Break Page Selection

The Break Page Selection feature allows displaying a page selection when you use "Page Break" for a long post.

The page selector at the top of a split post on the Default demo, outlined in orange, with its list open: the Section label, the current page and every page heading numbered in order

It renders above the post content, labelled Section, and each entry reads as the page number, then the heading you typed. It is not output on AMP pages.

Give every page a heading. With one missing, the selector does not show at all, and nothing tells you why.

To get started, follow the steps below:​

  1. Navigate to Posts > All Posts, then select and edit the post you would like.

  2. In the editor, insert a Page Break block wherever a new page should start.

    Searching page break in the block inserter returns the Page Break block

    The block is called Page Break and the inserter files it under Design.

    Count the pages, not the breaks. WordPress splits the content on each break, so two Page Break blocks give you three pages and you owe three headings.

  3. At the bottom of the editor, open the Meta Boxes bar, find the Single Post Settings box and open its Break Page Selection tab. Then input a heading for every page.

    The Single Post Settings box with the Break Page Selection tab open: Headings Table with three Input Heading rows, one per page, and the +Add Heading button

    Inside the tab is one field, Headings Table: press +Add Heading once per page and type the page's heading into Input Heading. The rows are read in the order you leave them in, so row 1 is page 1.

    On a custom post type the same tab is in the Single Post Type Settings box instead. Pages do not have it: Single Page Settings has no Break Page Selection tab.

  4. Click Save, or Publish on a new post, to save the changes.

Refer to Page Break Block for more details.

Related Articles