Skip to content

List Group

List groups display a series of items: plain lists, menus of links, option pickers, inboxes and settings screens. Make items actionable, colour or number them, lay them out horizontally, or switch content panes with data-bs-toggle="list".

1Basic list

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

  • API integrations
  • Secure file sharing
  • Smart reporting
  • Team analytics

2Active and disabled

Highlight the current item and dim unavailable ones.

  • Current plan
  • Upgrade options
  • Enterprise (contact sales)
  • Billing history

3Links and buttons

list-group-item-action adds hover and focus states to links and buttons.

OverviewMembers

4Flush list

list-group-flush removes outer borders so the list sits flush in a parent.

  • Open API
  • 99.99% uptime
  • Dark mode

5Numbered list

list-group-numbered on an ol adds counters, here with extra content per item.

  1. How we cut our release cycle in half
    Mar 19, 2026
    21
  2. What we learned shipping 200 releases
    Jul 19, 2026
    21
  3. Writing status updates people actually read
    Aug 18, 2026
    29

6Horizontal list

list-group-horizontal lays items in a row; -md makes it responsive.

  • 83.6k
    Visitors
  • 194
    Sign-ups
  • 64%
    Conversion

7Contextual colours

list-group-item-* colours individual items.

8With badges

Pill badges at the end of each item show counts.

  • Projects10
  • Tasks80
  • Issues2

9Custom content

Headings, text and meta inside each item, like a list of articles.

10Checkbox list

Checkboxes and labels in items make a simple to-do list.

11Radio option list

Whole list items as labels for radio buttons, e.g. a plan picker.

12List as tabs

data-bs-toggle="list" turns the list into tab navigation for panes next to it.

Friendly people answer your questions quickly, by phone, chat or email.

Two-step verification is on.

Our team has done this many times, so you never have to guess.

13Notification list

Avatars, message and time, with a dot for unread items.

14File list

File type icons, sizes and a download button per file.

  • inside-our-product-roadmap-for-next-year.pdf
    332 KB · Jan 20, 2026
  • how-one-support-team-cut-first-replies-to-20-minutes.png
    114 KB · Dec 8, 2025
  • the-real-cost-of-switching-between-tools.xlsx
    660 KB · Apr 11, 2026
  • how-to-choose-the-right-plan.zip
    696 KB · Jan 25, 2026

15Contact list

People with role and quick call and email actions.

  • Omar Moreau
    Omar Moreau
    Operations Manager
  • Freya Nguyen
    Freya Nguyen
    Product Designer
  • Felix Mensah
    Felix Mensah
    Customer Success

16Settings with switches

Each setting has an icon, a description and a switch on the right.

17Task progress list

Progress bars inside items track several jobs at once.

  • Flexible team100%
  • Clear community46%
  • Honest experience80%

18Inbox list

Unread messages in bold with a tinted edge; long lines are truncated.

19Leaderboard

Ranked people with medal badges, avatars and scores.

  1. 1Diego NovakDiego Novak872 pts
  2. 2Arjun KowalskiArjun Kowalski624 pts
  3. 3Mia SatoMia Sato578 pts
  4. 4Jonah HarlowJonah Harlow251 pts

20Reorderable list look

Grip handles signal that items can be reordered (wire up drag and drop in your app).

  • Audit trail1
  • Role-based access2
  • Dark mode3
  • Real-time collaboration4