---
title: Pagination
layout: docs
theme: library
doc-tab: components
doc-subtab: pagination
breadcrumb:
- home
- documentation
- components
- components-pagination
meta:
colors: false
sizes: true
variables: true
---
{% capture pagination_example %}
{% endcapture %}
{% capture pagination_options_example %}
{% endcapture %}
{% capture pagination_centered_example %}
{% endcapture %}
{% capture pagination_right_example %}
{% endcapture %}
{% capture pagination_rounded_example %}
{% endcapture %}
{% capture pagination_small_example %}
{% endcapture %}
{% capture pagination_medium_example %}
{% endcapture %}
{% capture pagination_large_example %}
{% endcapture %}
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 docs/elements/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 docs/elements/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 docs/elements/snippet.html content=pagination_centered_example
horizontal=true more=true
%}
{%
include docs/elements/snippet.html
content=pagination_right_example horizontal=true more=true
%}
{% include docs/elements/anchor.html name="Styles" %}