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.

  • Education fund
  • Disaster response
  • Volunteer programs
  • Clean water

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.

  • Volunteer network
  • Transparent reports
  • Local partners

5Numbered list

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

  1. Five things we learned this year
    May 25, 2026
    11
  2. Stories from the families we support
    Mar 23, 2026
    17
  3. Looking back at a busy season
    Jul 24, 2026
    15

6Horizontal list

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

  • 45.1k
    Visitors
  • 518
    Sign-ups
  • 21%
    Conversion

7Contextual colours

list-group-item-* colours individual items.

8With badges

Pill badges at the end of each item show counts.

  • Projects24
  • Tasks32
  • Issues4

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 helped more than two hundred thousand people since we started.

Two-step verification is on.

Clean water wells are built with and maintained by local communities.

13Notification list

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

14File list

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

  • why-we-plant-trees-with-the-schools-we-build.pdf
    65 KB · Aug 23, 2026
  • ten-ways-to-fundraise-with-friends.png
    419 KB · Oct 23, 2025
  • what-our-donors-asked-us-most.xlsx
    4 KB · Nov 30, 2025
  • a-beginner-s-guide-to-getting-started.zip
    195 KB · Jun 15, 2026

15Contact list

People with role and quick call and email actions.

  • Mason Kowalski
    Mason Kowalski
    QA Engineer
  • Jonah Ashford
    Jonah Ashford
    Operations Manager
  • Omar Hughes
    Omar Hughes
    Sales Executive

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 journey100%
  • Secure journey73%
  • Reliable launch81%

18Inbox list

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

19Leaderboard

Ranked people with medal badges, avatars and scores.

  1. 1Ravi OrtegaRavi Ortega1112 pts
  2. 2Aria CarterAria Carter894 pts
  3. 3Liam LindqvistLiam Lindqvist550 pts
  4. 4Hana VargaHana Varga234 pts

20Reorderable list look

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

  • Transparent reports1
  • Local partners2
  • Tax receipts3
  • Secure giving4