Skip to main content

Components

Pagination

Page links for long lists and results — active page in gold, no script.

How it works

Pagination is plain HTML: a <ul class="pagination"> of .page-item entries wrapped in a <nav>. Nothing is scripted. The theme sets the active page to gold with navy text, uses the 2px radius on each link and the gold focus ring.

  • Baseline: links. Works everywhere.
  • Enhancement: none needed.
  • Fallback: none needed.

Overview

Wrap the list in a <nav> with an aria-label that describes what is paged. Large blocks of links are easier to scan when the block has a clear role.

HTML
<nav aria-label="Results pages">
  <ul class="pagination">
    <li class="page-item"><a class="page-link" href="#!">Previous</a></li>
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item"><a class="page-link" href="#!">2</a></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
    <li class="page-item"><a class="page-link" href="#!">Next</a></li>
  </ul>
</nav>

Working with icons

Use an icon or symbol instead of text. Keep an aria-label on the link so the meaning survives for assistive technology.

HTML
<nav aria-label="Results pages">
  <ul class="pagination">
    <li class="page-item">
      <a class="page-link" href="#!" aria-label="Previous">
        <span aria-hidden="true">&laquo;</span>
      </a>
    </li>
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item"><a class="page-link" href="#!">2</a></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#!" aria-label="Next">
        <span aria-hidden="true">&raquo;</span>
      </a>
    </li>
  </ul>
</nav>

Disabled and active states

.disabled on a .page-item greys the link and sets pointer-events: none. Add tabindex="-1" and aria-disabled="true" so keyboard users skip it, or use a <span> instead of a link. .active marks the current page in gold; add aria-current="page".

HTML
<nav aria-label="Results pages">
  <ul class="pagination">
    <li class="page-item disabled">
      <a class="page-link" aria-disabled="true" tabindex="-1">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item active" aria-current="page">
      <a class="page-link" href="#!">2</a>
    </li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#!">Next</a>
    </li>
  </ul>
</nav>

You can also swap active or disabled anchors for <span>, which removes the click entirely.

HTML
<nav aria-label="Results pages">
  <ul class="pagination">
    <li class="page-item disabled">
      <span class="page-link">Previous</span>
    </li>
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item active" aria-current="page">
      <span class="page-link">2</span>
    </li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#!">Next</a>
    </li>
  </ul>
</nav>

Sizing

.pagination-lg and .pagination-sm change padding and font size.

HTML
<nav aria-label="Large pagination">
  <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="#!">2</a></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
  </ul>
</nav>
HTML
<nav aria-label="Small pagination">
  <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="#!">2</a></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
  </ul>
</nav>

Alignment

.pagination is a flex container, so flex utilities move it.

HTML
<nav aria-label="Centered pagination">
  <ul class="pagination justify-content-center">
    <li class="page-item disabled">
      <a class="page-link" aria-disabled="true">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item"><a class="page-link" href="#!">2</a></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#!">Next</a>
    </li>
  </ul>
</nav>
HTML
<nav aria-label="Right-aligned pagination">
  <ul class="pagination justify-content-end">
    <li class="page-item disabled">
      <a class="page-link" aria-disabled="true">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item"><a class="page-link" href="#!">2</a></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#!">Next</a>
    </li>
  </ul>
</nav>

CSS

Local variables on .pagination. The active colour is gold-700 in light mode and gold-500 in dark mode.

.pagination {
  --bs-pagination-padding-x: 0.75rem;
  --bs-pagination-padding-y: 0.375rem;
  --bs-pagination-font-size: 1rem;
  --bs-pagination-color: var(--bs-link-color);
  --bs-pagination-bg: var(--bs-body-bg);
  --bs-pagination-border-width: var(--bs-border-width);
  --bs-pagination-border-color: var(--bs-border-color);
  --bs-pagination-border-radius: 2px;
  --bs-pagination-hover-color: var(--bs-link-hover-color);
  --bs-pagination-hover-bg: var(--bs-tertiary-bg);
  --bs-pagination-hover-border-color: var(--bs-border-color);
  --bs-pagination-focus-color: var(--bs-link-hover-color);
  --bs-pagination-focus-bg: var(--bs-secondary-bg);
  --bs-pagination-focus-box-shadow: 0 0 0 0.25rem rgba(184, 148, 31, 0.4);
  --bs-pagination-active-color: #0a1b3d;
  --bs-pagination-active-bg: #b8941f;
  --bs-pagination-active-border-color: #b8941f;
  --bs-pagination-disabled-color: var(--bs-secondary-color);
  --bs-pagination-disabled-bg: var(--bs-secondary-bg);
  --bs-pagination-disabled-border-color: var(--bs-border-color);
}

[data-bs-theme="dark"] .pagination {
  --bs-pagination-active-bg: var(--bs-gold-500);
  --bs-pagination-active-border-color: var(--bs-gold-500);
}

Override on one instance with an inline style:

HTML
<nav aria-label="Navy pagination">
  <ul class="pagination" style="--bs-pagination-active-bg: var(--bs-navy); --bs-pagination-active-border-color: var(--bs-navy); --bs-pagination-active-color: var(--bs-cream);">
    <li class="page-item"><a class="page-link" href="#!">1</a></li>
    <li class="page-item active" aria-current="page"><span class="page-link">2</span></li>
    <li class="page-item"><a class="page-link" href="#!">3</a></li>
  </ul>
</nav>