More Articles

Implementing Pagination with Pagebreak on an Eleventy Site

Learn how to integrate Pagebreak with Eleventy to easily implement pagination on your static site.

Written on Jun 12, 2024 | About 2 min reading time

New tools in your inbox every Monday!

Implementing Pagination with Pagebreak on an Eleventy Site

Pagebreak is an open-source tool that simplifies the process of implementing pagination on static websites, including those built with Eleventy. In this article, we'll explore how to integrate Pagebreak into your Eleventy project and take advantage of its pagination features.

Installing Pagebreak

The easiest way to run Pagebreak is via NPX, which downloads the correct binary release for your platform. You can install it with the following command:

npx @pagebreak/cli -s _site -o _site

This command will paginate the website in-place, updating the source files in the `_site` directory.

Integrating Pagebreak with Eleventy

To integrate Pagebreak with your Eleventy build process, you can add the following code to your `eleventy.js` configuration file:

const { execSync } = require('child_process');

eleventyConfig.on('eleventy.after', () => {
 execSync(`npx @pagebreak/cli -s dist -o dist`, { encoding: 'utf-8' });

This code runs the Pagebreak command after the Eleventy build process is complete, paginating the files in the `dist` directory.

Configuring Pagination with Pagebreak

To paginate a section of your website, you can use the `data-pagebreak` attribute on the container element and specify the number of items per page. Eleventy can then output all the items onto the page, and Pagebreak will handle splitting them into separate paginated files.

  <section data-pagebreak="2">
   <article>Item 1</article>
   <article>Item 2</article>
   <article>Item 3</article>
   <article>Item 4</article>

In the example above, Pagebreak will split the content into two pages, with two articles on each page.

Pagination Navigation Controls

Pagebreak provides several controls for rendering pagination navigation elements, such as next/previous links and page numbers. These controls are implemented using the `data-pagebreak-control` attribute.

  <a data-pagebreak-control="prev">Previous</a>
  <a data-pagebreak-control="next">Next</a>
   <span data-pagebreak-label="current">1</span>
   <span data-pagebreak-label="total">1</span>

Pagebreak will update the URLs and content of these elements based on the current page and the total number of pages.

By integrating Pagebreak into your Eleventy project, you can streamline the process of implementing pagination on your static website, while maintaining separation of concerns between pagination logic and templating. For the full documentation visit the Pagebreak Github repo.

June Featured Tools

Ugly Deck

Simple straightforward pitch deck for your next project.



Focus on your business and avoid all the web hosting hassles. Our managed hosting guarantees unmatched performance, reliability and choice with 24/7 support that acts as your extended team, making Cloudways an ultimate choice for growing agencies and ecommerce businesses.


We Recommend...

Top products featured for the article.


An open source web analytics platform available as a hosted service (free for non-commercial use) or self-hosted app.



A text splitter that just f*cking works, cool text splitting animation library.


Wave Web App Starter

Wave will help you rapidly build a Software as a Service. Out of the box Authentication, Subscriptions, Invoices, Announcements, User Profiles, API, and so much more!


Make an easy way to contact you! Create & share a friendly contact page today.



See all Tools

A Little Extra Reading

Feel like reading more? Here are some extra articles to check out!

See all Articles