Pagination

Documentation and examples for showing pagination to indicate a series of related content exists across multiple pages.

Example

<ul class="pagination">
    <li class="page-item"><a class="page-link" href="javascript: void(0);">Previous</a></li>
    <li class="page-item"><a class="page-link" href="javascript: void(0);">1</a></li>
    <li class="page-item"><a class="page-link" href="javascript: void(0);">2</a></li>
    <li class="page-item"><a class="page-link" href="javascript: void(0);">3</a></li>
    <li class="page-item"><a class="page-link" href="javascript: void(0);">Next</a></li>
</ul>

Working with icons

Looking to use an icon or symbol in place of text for some pagination links? Be sure to provide proper screen reader support with aria attributes.

<nav aria-label="Page navigation example">
    <ul class="pagination">
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);" aria-label="Previous">
                <span aria-hidden="true">«</span>
            </a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">1</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">2</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">3</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);" aria-label="Next">
                <span aria-hidden="true">»</span>
            </a>
        </li>
    </ul>
</nav>

Disabled and active states

Pagination links are customizable for different circumstances. Use .disabled for links that appear un-clickable and .active to indicate the current page.

While the .disabled class uses pointer-events: none to try to disable the link functionality of <a>s, that CSS property is not yet standardized and doesn't account for keyboard navigation. As such, you should always add tabindex="-1" on disabled links and use custom JavaScript to fully disable their functionality.

<nav aria-label="...">
    <ul class="pagination">
        <li class="page-item disabled">
            <a class="page-link">Previous</a>
        </li>
        <li class="page-item"><a class="page-link" href="javascript: void(0);">1</a></li>
        <li class="page-item active" aria-current="page">
            <a class="page-link" href="javascript: void(0);">2</a>
        </li>
        <li class="page-item"><a class="page-link" href="javascript: void(0);">3</a></li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">Next</a>
        </li>
    </ul>
</nav>

Sizing

Fancy larger or smaller pagination? Add .pagination-lg or .pagination-sm for additional sizes.

<nav aria-label="...">
    <ul class="pagination pagination-lg">
        <li class="page-item active" aria-current="page">
            <span class="page-link">1</span>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">2</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">3</a>
        </li>
    </ul>
</nav>

<br>

<nav aria-label="...">
    <ul class="pagination pagination-sm">
        <li class="page-item active" aria-current="page">
            <span class="page-link">1</span>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">2</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">3</a>
        </li>
    </ul>
</nav>

Alignment

Change the alignment of pagination components with flexbox utilities. For example, with .justify-content-center:

<nav aria-label="Page navigation example">
    <ul class="pagination justify-content-center">
        <li class="page-item disabled">
            <a class="page-link">Previous</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">1</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">2</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">3</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">Next</a>
        </li>
    </ul>
</nav>

Or with .justify-content-end:

<nav aria-label="Page navigation example">
    <ul class="pagination justify-content-end">
        <li class="page-item disabled">
            <a class="page-link">Previous</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">1</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">2</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">3</a>
        </li>
        <li class="page-item">
            <a class="page-link" href="javascript: void(0);">Next</a>
        </li>
    </ul>
</nav>