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-ui-toggle="list".

1Basic list

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

  • Workflow automation
  • API integrations
  • Smart reporting
  • Secure file sharing

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
  • Audit trail
  • Real-time collaboration

5Numbered list

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

  1. Five things we learned this year
    Sep 12, 2025
    28
  2. Looking back at a busy season
    Mar 3, 2026
    8
  3. A practical guide to async work
    Aug 1, 2026
    30

6Horizontal list

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

  • 30.6k
    Visitors
  • 559
    Sign-ups
  • 31%
    Conversion

7Contextual colours

list-group-item-* colours individual items.

8With badges

Pill badges at the end of each item show counts.

  • Projects27
  • Tasks70
  • Issues8

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-ui-toggle="list" turns the list into tab navigation for panes next to it.

Every update lands in one place, so nothing gets lost in email threads.

Two-step verification is on.

Teams report saving around five hours a week after the first month.

13Notification list

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

14File list

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

  • how-we-cut-our-release-cycle-in-half.pdf
    840 KB · Jan 24, 2026
  • how-to-choose-the-right-plan.png
    726 KB · Jul 26, 2026
  • a-beginner-s-guide-to-getting-started.xlsx
    713 KB · Dec 29, 2025
  • inside-our-product-roadmap-for-next-year.zip
    757 KB · Jun 20, 2026

15Contact list

People with role and quick call and email actions.

  • Noah Whitaker
    Noah Whitaker
    Product Designer
  • Arjun Delgado
    Arjun Delgado
    Project Manager
  • Isla Haddad
    Isla Haddad
    Content Writer

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.

  • Calm journey100%
  • Secure community45%
  • Focused team35%

18Inbox list

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

19Leaderboard

Ranked people with medal badges, avatars and scores.

  1. 1Theo HughesTheo Hughes1076 pts
  2. 2Nora SilvaNora Silva777 pts
  3. 3Kai OkaforKai Okafor470 pts
  4. 4Zoe OrtegaZoe Ortega275 pts

20Reorderable list look

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

  • 99.99% uptime1
  • Dark mode2
  • Role-based access3
  • Audit trail4