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>Links and buttons
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.
- Bret Hart
- Shawn Michaels
- 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>-
14Hart FoundationTwo-time tag team champions
-
478DemolitionLongest single reign of the era
-
0The RockersNever officially recognised
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>.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.
Survivor Series 1997
MontrealThe finish nobody in the building expected. The bell rang early.
Main event · 12:19WrestleMania III
PontiacThe slam heard round the world, in front of a record crowd.
Main event · 12:01King of the Ring 1998
PittsburghHell in a Cell. Sixteen feet. Through the announce table.
Semi-main · 17:00HTML
<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).