Edit on GitHub
Jump to docs navigation

Twig Components / Pagination

Note: You are currently reading the documentation for Bolt 5.0. Looking for the documentation for Bolt 5.2 instead?

You can use the {{ pager }} tag to create pagination elements for your visitors to navigate between the different pages of a listing.

{{ pager(records) }}

Splits records into pages with a pager using the an optional template, class and surround.

Argument Description
records The content records to build the pager for.
template The relative path to the template used to generate the pager. The template must be located under /templates. Default value is "helpers/_pager_basic.html.twig"
class An optional class parameter passed to the template. Default is pagination.
surround The amount of items to show around the 'current' one. "3" by default.

For example:

{{ pager(records=blogposts, template = 'helpers/_pager_basic.html.twig', class='awesome-posts', surround=5) }}

If you use all of the available options, then you can omit the names of the arguments, like this:

{{ pager(blogposts, 'helpers/_pager_basic.html.twig', 'awesome-posts', 5) }}

If you need just one of the options, you need to add the named argument, for example:

{{ pager(records=blogposts, surround=5) }}

You can define the template used for the pager yourself, or use one of the default ones:

Argument Description
helpers/_pager_basic.html.twig A basic pager, without much opinionated styling
helpers/_pager_bootstrap.html.twig Works well, if you're building a theme based on Bootstrap
helpers/_pager_bulma.html.twig Works well, if you're building a theme based on Bulma

If you wish to create your own template, you can copy one of the above from vendor/bolt/core/templates/helpers/ to your own theme's template folder.



Edit this page on GitHub
Couldn't find what you were looking for? We are happy to help you in the forum, on Slack or on Github.