Pagination divides a Query Loop into manageable result pages and gives visitors a way to reach older items. The pagination controls must belong to the intended query, especially when a page contains more than one post list.
IN THIS ARTICLE
01 Choose a sensible page size
Set an item count that fits the layout and keeps the page responsive. A small homepage highlights section may only need a link to the full archive, while an archive or resource library usually needs a clear next-page route.
Prepare enough matching posts to create at least two result pages. Without that test data, a pagination control can appear absent simply because there are no further results.
02 Add and arrange the controls
- Select the intended Query Loop in List View and review its item count, filters and query mode.
- Keep the Post Template inside the loop and add the Pagination block in the query's supported structure.
- Include suitable Previous, page-number and Next controls as needed. Use labels that communicate direction clearly.
- Save and open the public page, then follow the pagination links.
03 Verify the result pages
Check that the second page displays different expected posts and that returning to the first page works. Confirm that the page title, query filters and surrounding layout remain appropriate. If several loops exist, verify that using one loop's controls does not create confusing behaviour in another.
Test with caching enabled after the correct result is established. Some configurations mishandle query parameters or serve the first page for every pagination URL. Give support the exact first- and second-page URLs if that happens.
What can break Query Loop pagination?
A Pagination block placed outside its query context may not know which results to paginate. An offset or custom query modification can also affect totals, so use those options only with a clear reason and test the final page.
If clicking Next returns a 404, review the published URL, permalink routing and query configuration before deleting posts or changing their dates. A pagination problem is usually a display or routing issue, not evidence that the underlying articles are missing. Keep a direct archive link available while investigating an important public listing.