List groups

Lists are a collection of small amounts of information that the user should see in a single page. Lists are a good alternative to tables/grids, as the most important information is clearly emphasized using different visual approaches. Read more about lists in the UX Guidelines.

Use when

  • To display small amounts of data in a structured way and the need for filtering and sorting is low
  • To give the user an overview of a set of alternatives

Design

Default list group

The most basic list group is simply an unordered list with items.

  • Cras justo odio
  • Dapibus ac facilisis in
  • Morbi leo risus
  • Porta ac consectetur ac
  • Vestibulum at eros

Primary list group

There is a alternative background color, it just need .list-group-primary class along with the default class of the list group main wrapper .list-group

  • Cras justo odio
  • Dapibus ac facilisis in
  • Morbi leo risus
  • Porta ac consectetur ac
  • Vestibulum at eros

Group list with interactions

Linkify list group items by using anchor tags - <a> - instead of list items, that also means using a parent <div> instead of an <ul>. No need for individual parents around each element.

Default

Primary

Options

Badges

Add badges to any list group item and it will automatically be positioned on the right.

By adding .badge-nopill class to the badge element will remove the pill efect for alternative/blue list group.

  • 21Cras justo odio
  • 9Cras justo odio
  • 4Disabled list item
  • Morbi leo risus1
  • 7Selected list item
  • Vestibulum at eros3

Custom content

Adding footer to your list:

Alternative header for basic list group, add .list-group-header class to the .list-group-title element.

Add nearly any HTML within, even for linked list groups like the one below.