Skip to main content

Components

List group

Flexible lists of content — plain, linked, numbered, horizontal, coloured — with no script involved.

How it works

List groups are static Bootstrap markup. Nothing here ever needed JavaScript, so the component is unchanged apart from the theme: the active item is gold with navy text, corners use the 6px radius, and the brand colours gold, navy and cream get their own contextual variants.

  • Baseline: plain HTML lists, links or buttons. Works everywhere.
  • Enhancement: none needed.
  • Fallback: none needed.

Basic example

An unordered list with .list-group and .list-group-item children.

  • Opening match
  • Tag team title defence
  • Intercontinental ladder match
  • Women's championship
  • Main event — steel cage
HTML
<ul class="list-group">
  <li class="list-group-item">Opening match</li>
  <li class="list-group-item">Tag team title defence</li>
  <li class="list-group-item">Intercontinental ladder match</li>
  <li class="list-group-item">Women's championship</li>
  <li class="list-group-item">Main event — steel cage</li>
</ul>

Active items

Add .active to mark the current selection. The theme paints it gold with navy text in light mode and gold-500 in dark mode.

  • Main event — steel cage
  • Tag team title defence
  • Intercontinental ladder match
  • Women's championship
HTML
<ul class="list-group">
  <li class="list-group-item active" aria-current="true">Main event — steel cage</li>
  <li class="list-group-item">Tag team title defence</li>
  <li class="list-group-item">Intercontinental ladder match</li>
  <li class="list-group-item">Women's championship</li>
</ul>

Disabled items

Add .disabled to grey an item out. On a <li> or <a> this is cosmetic only; the CSS sets pointer-events: none but keyboard users can still reach a link. For real disabling use a <button disabled>.

  • Cancelled — injury
  • Tag team title defence
  • Intercontinental ladder match
HTML
<ul class="list-group">
  <li class="list-group-item disabled" aria-disabled="true">Cancelled — injury</li>
  <li class="list-group-item">Tag team title defence</li>
  <li class="list-group-item">Intercontinental ladder match</li>
</ul>

Use <a> or <button> with .list-group-item-action for hover, focus and active styles. Do not use .btn here. Buttons need type="button" and the wrapper becomes a <div>, not a <ul>.

HTML
<div class="list-group">
  <a href="#!" class="list-group-item list-group-item-action active" aria-current="true">Results</a>
  <a href="#!" class="list-group-item list-group-item-action">Rankings</a>
  <a href="#!" class="list-group-item list-group-item-action">Title history</a>
  <a href="#!" class="list-group-item list-group-item-action">Roster</a>
  <a class="list-group-item list-group-item-action disabled" aria-disabled="true">Archive (coming soon)</a>
</div>
HTML
<div class="list-group">
  <button type="button" class="list-group-item list-group-item-action active" aria-current="true">Results</button>
  <button type="button" class="list-group-item list-group-item-action">Rankings</button>
  <button type="button" class="list-group-item list-group-item-action">Title history</button>
  <button type="button" class="list-group-item list-group-item-action">Roster</button>
  <button type="button" class="list-group-item list-group-item-action" disabled>Archive (coming soon)</button>
</div>

Flush

Add .list-group-flush to remove the outer border and radius so the list sits edge-to-edge in a card or sidebar.

  • Opening match
  • Tag team title defence
  • Intercontinental ladder match
  • Main event — steel cage
HTML
<ul class="list-group list-group-flush">
  <li class="list-group-item">Opening match</li>
  <li class="list-group-item">Tag team title defence</li>
  <li class="list-group-item">Intercontinental ladder match</li>
  <li class="list-group-item">Main event — steel cage</li>
</ul>

Numbered

Add .list-group-numbered to an <ol>. Numbers come from a CSS counter, so nested lists count as 1.1, 1.2 and the numbers sit beside custom content.

  1. Bret Hart
  2. Shawn Michaels
  3. The Undertaker
HTML
<ol class="list-group list-group-numbered">
  <li class="list-group-item">Bret Hart</li>
  <li class="list-group-item">Shawn Michaels</li>
  <li class="list-group-item">The Undertaker</li>
</ol>
  1. Hart Foundation
    Two-time tag team champions
    14
  2. Demolition
    Longest single reign of the era
    478
  3. The Rockers
    Never officially recognised
    0
HTML
<ol class="list-group list-group-numbered">
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Hart Foundation</div>
      Two-time tag team champions
    </div>
    <span class="badge text-bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Demolition</div>
      Longest single reign of the era
    </div>
    <span class="badge text-bg-primary rounded-pill">478</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">The Rockers</div>
      Never officially recognised
    </div>
    <span class="badge text-bg-primary rounded-pill">0</span>
  </li>
</ol>

Horizontal

Add .list-group-horizontal to lay items out in a row. Responsive variants .list-group-horizontal-{sm|md|lg|xl|xxl} go horizontal from that breakpoint up. Horizontal lists cannot be combined with .list-group-flush.

  • Red corner
  • Referee
  • Blue corner
  • Red corner
  • Referee
  • Blue corner
HTML
<ul class="list-group list-group-horizontal mb-4">
  <li class="list-group-item">Red corner</li>
  <li class="list-group-item">Referee</li>
  <li class="list-group-item">Blue corner</li>
</ul>
<ul class="list-group list-group-horizontal-md">
  <li class="list-group-item">Red corner</li>
  <li class="list-group-item">Referee</li>
  <li class="list-group-item">Blue corner</li>
</ul>

Want equal widths? Add .flex-fill to every item.

  • Red corner
  • Referee
  • Blue corner
HTML
<ul class="list-group list-group-horizontal">
  <li class="list-group-item flex-fill">Red corner</li>
  <li class="list-group-item flex-fill">Referee</li>
  <li class="list-group-item flex-fill">Blue corner</li>
</ul>

Variants

Contextual classes tint an item with the subtle background and emphasis text for each theme colour. The three brand colours have their own variants: .list-group-item-gold, .list-group-item-navy and .list-group-item-cream. All of them adapt in dark mode.

  • A simple default list group item
  • A simple primary list group item
  • A simple secondary list group item
  • A simple success list group item
  • A simple danger list group item
  • A simple warning list group item
  • A simple info list group item
  • A simple light list group item
  • A simple dark list group item
  • A simple gold list group item
  • A simple navy list group item
  • A simple cream list group item
HTML
<ul class="list-group">
  <li class="list-group-item">A simple default list group item</li>
  <li class="list-group-item list-group-item-primary">A simple primary list group item</li>
  <li class="list-group-item list-group-item-secondary">A simple secondary list group item</li>
  <li class="list-group-item list-group-item-success">A simple success list group item</li>
  <li class="list-group-item list-group-item-danger">A simple danger list group item</li>
  <li class="list-group-item list-group-item-warning">A simple warning list group item</li>
  <li class="list-group-item list-group-item-info">A simple info list group item</li>
  <li class="list-group-item list-group-item-light">A simple light list group item</li>
  <li class="list-group-item list-group-item-dark">A simple dark list group item</li>
  <li class="list-group-item list-group-item-gold">A simple gold list group item</li>
  <li class="list-group-item list-group-item-navy">A simple navy list group item</li>
  <li class="list-group-item list-group-item-cream">A simple cream list group item</li>
</ul>

For links and buttons

Variants also work with .list-group-item-action. Hover and focus darken the tint; .active applies the gold.

HTML
<div class="list-group">
  <a href="#!" class="list-group-item list-group-item-action">A simple default list group item</a>
  <a href="#!" class="list-group-item list-group-item-action list-group-item-primary">A simple primary list group item</a>
  <a href="#!" class="list-group-item list-group-item-action list-group-item-success">A simple success list group item</a>
  <a href="#!" class="list-group-item list-group-item-action list-group-item-danger">A simple danger list group item</a>
  <a href="#!" class="list-group-item list-group-item-action list-group-item-gold">A simple gold list group item</a>
  <a href="#!" class="list-group-item list-group-item-action list-group-item-navy">A simple navy list group item</a>
  <a href="#!" class="list-group-item list-group-item-action list-group-item-cream">A simple cream list group item</a>
</div>
Colour alone is not an explanation. If a tint carries meaning, say it in the text too or add a .visually-hidden label.

With badges

Pair with badges and flex utilities for counts.

  • Unread match reports 14
  • Pending contracts 2
  • Open challenges 1
HTML
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Unread match reports
    <span class="badge text-bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Pending contracts
    <span class="badge text-bg-primary rounded-pill">2</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Open challenges
    <span class="badge text-bg-primary rounded-pill">1</span>
  </li>
</ul>

Custom content

Any HTML goes inside an item. Flex utilities keep headings, dates and body text lined up.

HTML
<div class="list-group">
  <a href="#!" class="list-group-item list-group-item-action active" aria-current="true">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">Survivor Series 1997</h5>
      <small>Montreal</small>
    </div>
    <p class="mb-1">The finish nobody in the building expected. The bell rang early.</p>
    <small>Main event · 12:19</small>
  </a>
  <a href="#!" class="list-group-item list-group-item-action">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">WrestleMania III</h5>
      <small class="text-body-secondary">Pontiac</small>
    </div>
    <p class="mb-1">The slam heard round the world, in front of a record crowd.</p>
    <small class="text-body-secondary">Main event · 12:01</small>
  </a>
  <a href="#!" class="list-group-item list-group-item-action">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">King of the Ring 1998</h5>
      <small class="text-body-secondary">Pittsburgh</small>
    </div>
    <p class="mb-1">Hell in a Cell. Sixteen feet. Through the announce table.</p>
    <small class="text-body-secondary">Semi-main · 17:00</small>
  </a>
</div>

Checkboxes and radios

Place form checks inside items. Wrap the control in a <label class="list-group-item"> so the whole row is clickable.

HTML
<ul class="list-group">
  <li class="list-group-item">
    <input class="form-check-input me-2" type="checkbox" value="" id="list-group-check-1">
    <label class="form-check-label" for="list-group-check-1">Confirm pyro budget</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-2" type="checkbox" value="" id="list-group-check-2">
    <label class="form-check-label" for="list-group-check-2">Book the ring crew</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-2" type="checkbox" value="" id="list-group-check-3" checked>
    <label class="form-check-label" for="list-group-check-3">Print the programme</label>
  </li>
</ul>
HTML
<div class="list-group">
  <label class="list-group-item d-flex gap-2">
    <input class="form-check-input flex-shrink-0" type="radio" name="list-group-radio" value="" checked>
    <span>
      Cage match
      <small class="d-block text-body-secondary">Win by pinfall, submission or escape.</small>
    </span>
  </label>
  <label class="list-group-item d-flex gap-2">
    <input class="form-check-input flex-shrink-0" type="radio" name="list-group-radio" value="">
    <span>
      Ladder match
      <small class="d-block text-body-secondary">Retrieve the belt to win.</small>
    </span>
  </label>
  <label class="list-group-item d-flex gap-2">
    <input class="form-check-input flex-shrink-0" type="radio" name="list-group-radio" value="">
    <span>
      Iron man match
      <small class="d-block text-body-secondary">Most falls in sixty minutes.</small>
    </span>
  </label>
</div>

CSS

Local variables are set on .list-group. The theme values worth knowing: the active colour is gold-700 (#b8941f) with navy-900 text in light mode, and gold-500 in dark mode.

.list-group {
  --bs-list-group-color: var(--bs-body-color);
  --bs-list-group-bg: var(--bs-body-bg);
  --bs-list-group-border-color: var(--bs-border-color);
  --bs-list-group-border-width: var(--bs-border-width);
  --bs-list-group-border-radius: var(--bs-border-radius);
  --bs-list-group-item-padding-x: 1rem;
  --bs-list-group-item-padding-y: 0.5rem;
  --bs-list-group-action-color: var(--bs-secondary-color);
  --bs-list-group-action-hover-color: var(--bs-emphasis-color);
  --bs-list-group-action-hover-bg: var(--bs-tertiary-bg);
  --bs-list-group-action-active-color: var(--bs-body-color);
  --bs-list-group-action-active-bg: var(--bs-secondary-bg);
  --bs-list-group-disabled-color: var(--bs-secondary-color);
  --bs-list-group-disabled-bg: var(--bs-body-bg);
  --bs-list-group-active-color: #0a1b3d;
  --bs-list-group-active-bg: #b8941f;
  --bs-list-group-active-border-color: #b8941f;
}

/* dark mode swaps the accent */
[data-bs-theme="dark"] .list-group {
  --bs-list-group-active-bg: var(--bs-gold-500);
  --bs-list-group-active-border-color: var(--bs-gold-500);
}

Override per instance with an inline style or a wrapper class:

  • Navy active item
  • Second item
  • Third item
HTML
<ul class="list-group" style="--bs-list-group-active-bg: var(--bs-navy); --bs-list-group-active-border-color: var(--bs-navy); --bs-list-group-active-color: var(--bs-cream);">
  <li class="list-group-item active" aria-current="true">Navy active item</li>
  <li class="list-group-item">Second item</li>
  <li class="list-group-item">Third item</li>
</ul>

Related: Flex utilities, Scrollspy (list groups can be spied).