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.

  • Dine-in
  • Wine pairing
  • Private events
  • Takeaway

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.

  • Online reservations
  • Local ingredients
  • Vegan options

5Numbered list

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

  1. Our favourite tips for busy weeks
    Sep 13, 2026
    6
  2. What our guests asked us most
    Sep 20, 2025
    28
  3. Looking back at a busy season
    Nov 14, 2025
    20

6Horizontal list

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

  • 72.3k
    Visitors
  • 493
    Sign-ups
  • 9%
    Conversion

7Contextual colours

list-group-item-* colours individual items.

8With badges

Pill badges at the end of each item show counts.

  • Projects22
  • Tasks75
  • Issues7

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.

We have been feeding this neighbourhood for over a decade, and we still love it.

Two-step verification is on.

Cooking classes on Saturday mornings teach you our favourite recipes.

13Notification list

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

14File list

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

  • a-beginner-s-guide-to-getting-started.pdf
    238 KB · Jan 9, 2026
  • five-wines-to-pair-with-a-summer-dinner.png
    203 KB · Jul 11, 2026
  • three-pasta-shapes-to-make-at-home.xlsx
    812 KB · Feb 1, 2026
  • how-we-make-our-sourdough-every-morning.zip
    181 KB · Jul 18, 2026

15Contact list

People with role and quick call and email actions.

  • Ivy Lindqvist
    Ivy Lindqvist
    Backend Engineer
  • Ava Patel
    Ava Patel
    Backend Engineer
  • Aria Rossi
    Aria Rossi
    QA Engineer

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.

  • Honest experience100%
  • Flexible community27%
  • Bright plan68%

18Inbox list

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

19Leaderboard

Ranked people with medal badges, avatars and scores.

  1. 1Ethan HaddadEthan Haddad1168 pts
  2. 2Arjun IbrahimArjun Ibrahim714 pts
  3. 3Mason MorganMason Morgan504 pts
  4. 4Isla MensahIsla Mensah222 pts

20Reorderable list look

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

  • Fast delivery1
  • Online reservations2
  • Vegan options3
  • Local ingredients4