Navigation

Pagination

The Pagination block shows links to the previous and the next page of posts. Ghost splits your home page, tag pages and author pages into pages of posts, and this block lets visitors move between them. You find it in the Content group of the block picker. Put it in the same Section as the Collection that lists the page's posts, under the Collection, or inside a Group, a No Results or a Paywall.

The last row of a post grid and a Next link under it, at the left
Default
The last row of a post grid, with a Page 1 of 4 counter in the middle under it and a Next link at the right
With counter

When it shows

The block shows only on a page with more posts than Posts per page in Project settings › Features, and only on the pages that list posts, which are the home page, tag pages and author pages. On the first page it shows only the next link, and on the last page only the previous link.

The links go to Ghost's page addresses, such as /page/2/ or /tag/travel/page/2/. There are no page numbers to click and no button that loads more posts in place. On the canvas, the demo posts fill several pages, so the block shows.

The Collection above it must list the page's own posts, so that the second page shows the next posts. Split post lists into pages explains how to set this up.

Variant

Setting What it does
Variant Default shows the two links. With counter also shows the page number between them, such as "Page 1 of 4".

The variants come from the Pagination entry in the Blocks panel. How block variants and formats work explains variants.

General

Setting What it does
Previous Label The words of the link on the left, to the newer posts, ← Previous by default.
Next Label The words of the link to the older posts, Next → by default. It sits on the right when both links show.

Shared settings

The Pagination block also has Width from the Layout settings, Margin from the Spacing group, the Display settings and the Advanced settings.

Was this article helpful?