--- title: Pagination layout: documentation doc-tab: components doc-subtab: pagination --- {% capture pagination_example %} {% endcapture %} {% capture pagination_options_example %} {% endcapture %} {% capture pagination_centered_example %} {% endcapture %} {% capture pagination_right_example %} {% endcapture %} {% capture pagination_small_example %} {% endcapture %} {% capture pagination_medium_example %} {% endcapture %} {% capture pagination_large_example %} {% endcapture %} {% include subnav-components.html %}

Pagination

A responsive, usable, and flexible pagination

{% include meta.html colors=false sizes=true variables=true %}

The pagination component consists of several elements:

  • pagination-previous and pagination-next for incremental navigation
  • pagination-list which displays page items:
    • pagination-link for the page numbers
    • pagination-ellipsis for range separators

All elements are optional so you can compose your pagination as you wish.

{% include snippet.html content=pagination_example horizontal=true more=true %}

You can disable some links if they are not active, or change the amount of page numbers available.

{% include snippet.html content=pagination_options_example horizontal=true more=true %}

By default on tablet, the list is located on the left, and the previous/next buttons on the right. But you can change the order of these elements by using the is-centered and is-right modifiers.

{% include snippet.html content=pagination_centered_example horizontal=true more=true %} {% include snippet.html content=pagination_right_example horizontal=true more=true %} {% include anchor.html name="Sizes" %}

The pagination comes in 3 additional sizes.
You only need to append the modifier is-small, is-medium, or is-large to the pagination component.

{% include snippet.html content=pagination_small_example horizontal=true more=true %} {% include snippet.html content=pagination_medium_example horizontal=true more=true %} {% include snippet.html content=pagination_large_example horizontal=true more=true %} {% include variables.html type='component' %}