Pagination Block

Pagination Block provides pagination that works with your Loop Block.

This gives users control over the page view, enabling them to navigate to pages either by clicking a page number, or using the next and previous buttons. Using pagination allows your site to be more performant, because when you have larger sets of data you’re able to avoid overloading the server by fetching all the posts at once.

Minimalist styled pagination block from ACF Engine.
Minimalist styled pagination block from ACF Engine.

As a design consideration, we recommend being as generous as possible in terms of the number of results shown per page. If the loading is reasonably fast at 25 items per page, then use this higher number. Users report frustration when sites give them a very low number of results per page such as 5 or 10, forcing them to then navigation from page to page. While the pagination feature makes navigation fast and easy, it’s still better for users to find what they want on the current page.

Pagination Block works along with other Data Collection blocks in ACF Engine including filters, search and sorting blocks. You’ll find that when you combined Pagination Block with other Data Collection blocks, your pagination will be refreshed when the user interacts with filters and search. As the result set changes for instance, the number of page links shown will be updated to reflect the current data set.

Pagination Block works using requests instead of a page refresh. This is one of the key differences between using ACF Engine’s pagination block instead of the core WordPress pagination block contained in the Query Block. That core block has 2 major drawbacks, first the entire page refreshes on each click of the pagination. And then secondly because it uses the core Query Block to render the data, it’s also not possible to provide search, filtering or sorting. At least those features are not available at the time of this writing (June 23, 2022). The Query Block of course may evolve and improve to provide more features, and it’s already great for simple rendering of post lists, but when you want something more sophisticated, when you want to provide great interaction for larger data sets, you’ll need the modern approach found in ACF Engine blocks. The event-driven nature of our Data Collection blocks enable each block including Pagination Block to work together forming a seamless system.

Block Options

There are currently no block options for the Pagination Block.

Block Renders

Default render style for the Pagination Block in ACF Engine.
Pagination Block in the Gutenberg tree.

Development Roadmap

We have plans to improve the styling options in two major ways. First to provide preset styles. Secondly to provide more granular style options through the block settings. This can be expected for the v1.5.0 release in August 2022.