List group

Flexible component for displaying a series of content.

React Bootstrap docs

Basic example

  • Active item here
  • Dapibus ac facilisis in
  • Disabled item here
  • Porta ac consectetur ac
  • Vestibulum at eros
import ListGroup from 'react-bootstrap/ListGroup'

{/* Basic list group */}
<ListGroup as='ul'>
  <ListGroup.Item as='li' active>Active item here</ListGroup.Item>
  <ListGroup.Item as='li'>Dapibus ac facilisis in</ListGroup.Item>
  <ListGroup.Item as='li' disabled>Disabled item here</ListGroup.Item>
  <ListGroup.Item as='li'>Porta ac consectetur ac</ListGroup.Item>
  <ListGroup.Item as='li'>Vestibulum at eros</ListGroup.Item>
</ListGroup>

Flush

  • Cras justo odio
  • Dapibus ac facilisis in
  • Morbi leo risus
  • Porta ac consectetur ac
  • Vestibulum at eros
import ListGroup from 'react-bootstrap/ListGroup'

{/* Flush list group to use edge-to-edge in a parent container */}
<ListGroup as='ul' variant='flush'>
  <ListGroup.Item as='li'>Cras justo odio</ListGroup.Item>
  <ListGroup.Item as='li'>Dapibus ac facilisis in</ListGroup.Item>
  <ListGroup.Item as='li'>Morbi leo risus</ListGroup.Item>
  <ListGroup.Item as='li'>Porta ac consectetur ac</ListGroup.Item>
  <ListGroup.Item as='li'>Vestibulum at eros</ListGroup.Item>
</ListGroup>

With icons & badges

  • Messages14
  • Orders2
  • Favorites6
import ListGroup from 'react-bootstrap/ListGroup'
import Badge from 'react-bootstrap/Badge'

{/* List group with icons and badges */}
<ListGroup as='ul'>
  <ListGroup.Item as='li' className='d-flex align-items-center'>
    <i className='fi-chat-left text-muted me-2'></i>
    Messages
    <Badge bg='success' className='ms-auto'>14</Badge>
  </ListGroup.Item>
  <ListGroup.Item as='li' className='d-flex align-items-center'>
    <i className='fi-shopping-bag fs-lg mt-n1 text-muted me-2'></i>
    Orders
    <Badge bg='warning' className='ms-auto'>2</Badge>
  </ListGroup.Item>
  <ListGroup.Item as='li' className='d-flex align-items-center'>
    <i className='fi-heart text-muted me-2'></i>
    Favorites
    <Badge bg='danger' className='ms-auto'>6</Badge>
  </ListGroup.Item>
</ListGroup>

Numbered list group

  1. Cras justo odio
  2. Dapibus ac facilisis in
  3. Morbi leo risus
  4. Vestibulum at eros
import ListGroup from 'react-bootstrap/ListGroup'

{/* Numbered list group */}
<ListGroup as='ol' numbered>
  <ListGroup.Item as='li'>Cras justo odio</ListGroup.Item>
  <ListGroup.Item as='li'>Dapibus ac facilisis in</ListGroup.Item>
  <ListGroup.Item as='li'>Morbi leo risus</ListGroup.Item>
  <ListGroup.Item as='li'>Vestibulum at eros</ListGroup.Item>
</ListGroup>

Horizontal list group

Cras justo odio
Dapibus ac facilisis in
Morbi leo risus
Cras justo odio
Dapibus ac facilisis in
Morbi leo risus
import ListGroup from 'react-bootstrap/ListGroup'

{/* Basic horizontal list group (starting sm breackpoint). Choose between responsive breackpoints: sm, md, lg, xl, xxl */}
<ListGroup horizontal='sm'>
  <ListGroup.Item>Cras justo odio</ListGroup.Item>
  <ListGroup.Item>Dapibus ac facilisis in</ListGroup.Item>
  <ListGroup.Item>Morbi leo risus</ListGroup.Item>
</ListGroup>

{/* Justified horizontal list group (starting sm screen) */}
<ListGroup horizontal='sm'>
  <ListGroup.Item className='flex-fill text-center'>Cras justo odio</ListGroup.Item>
  <ListGroup.Item className='flex-fill text-center'>Dapibus ac facilisis in</ListGroup.Item>
  <ListGroup.Item className='flex-fill text-center'>Morbi leo risus</ListGroup.Item>
</ListGroup>

Actionable horizontal list group

import ListGroup from 'react-bootstrap/ListGroup'

{/* Actionable horizontal list group (starting sm screen) */}
<ListGroup horizontal='sm' defaultActiveKey='#link1'>
  <ListGroup.Item action href='#link1' className='text-center'>Active item here</ListGroup.Item>
  <ListGroup.Item action href='#link2' className='text-center'>Dapibus ac facilisis in</ListGroup.Item>
  <ListGroup.Item action href='#link3' className='text-center'>Morbi leo risus</ListGroup.Item>
</ListGroup>

Contextual classes

A simple primary list group item
A simple secondary list group item
A simple accent list group item
A simple success list group item
A simple danger list group item
A simple warning list group item
A simple info list group item
A simple light list group item
A simple dark list group item
import ListGroup from 'react-bootstrap/ListGroup'

{/* Contextual classes on basic list group */}
<ListGroup>
  <ListGroup.Item variant='primary'>A simple primary list group item</ListGroup.Item>
  <ListGroup.Item variant='secondary'>A simple secondary list group item</ListGroup.Item>
  <ListGroup.Item variant='accent'>A simple accent list group item</ListGroup.Item>
  <ListGroup.Item variant='success'>A simple success list group item</ListGroup.Item>
  <ListGroup.Item variant='danger'>A simple danger list group item</ListGroup.Item>
  <ListGroup.Item variant='warning'>A simple warning list group item</ListGroup.Item>
  <ListGroup.Item variant='info'>A simple info list group item</ListGroup.Item>
  <ListGroup.Item variant='light'>A simple light list group item</ListGroup.Item>
  <ListGroup.Item variant='dark'>A simple dark list group item</ListGroup.Item>
</ListGroup>

{/* Contextual classes on actionable list group */}
<ListGroup>
  <ListGroup.Item action variant='primary'>A link primary list group item</ListGroup.Item>
  <ListGroup.Item action variant='secondary'>A link secondary list group item</ListGroup.Item>
  <ListGroup.Item action variant='accent'>A link accent list group item</ListGroup.Item>
  <ListGroup.Item action variant='success'>A link success list group item</ListGroup.Item>
  <ListGroup.Item action variant='danger'>A link danger list group item</ListGroup.Item>
  <ListGroup.Item action variant='warning'>A link warning list group item</ListGroup.Item>
  <ListGroup.Item action variant='info'>A link info list group item</ListGroup.Item>
  <ListGroup.Item action variant='light'>A link light list group item</ListGroup.Item>
  <ListGroup.Item action variant='dark'>A link dark list group item</ListGroup.Item>
</ListGroup>

Custom content

List group item heading
3 days ago

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit. Excepteur sint occaecat cupidatat. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit.

Donec id elit non mi porta.
List group item heading
3 days ago

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit. Excepteur sint occaecat cupidatat. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit.

Donec id elit non mi porta.
List group item heading
3 days ago

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit. Excepteur sint occaecat cupidatat. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit.

Donec id elit non mi porta.
import ListGroup from 'react-bootstrap/ListGroup'

{/* List group with custom content */}
<ListGroup>
  <ListGroup.Item active className='py-3'>
    <div className='d-flex flex-wrap w-100 justify-content-between'>
      <h6 className='text-white'>List group item heading</h6>
      <small className='text-white opacity-50 mb-2'>3 days ago</small>
    </div>
    <p className='fs-sm font-weight-normal text-white opacity-75'>Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit. Excepteur sint occaecat cupidatat. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit.</p>
    <small className='text-white opacity-50'>Donec id elit non mi porta.</small>
  </ListGroup.Item>
  <ListGroup.Item className='py-3'>
    <div className='d-flex flex-wrap w-100 justify-content-between'>
      <h6>List group item heading</h6>
      <small className='text-muted mb-2'>3 days ago</small>
    </div>
    <p className='fs-sm font-weight-normals'>Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit. Excepteur sint occaecat cupidatat. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit.</p>
    <small className='text-muted'>Donec id elit non mi porta.</small>
  </ListGroup.Item>
  <ListGroup.Item className='py-3'>
    <div className='d-flex flex-wrap w-100 justify-content-between'>
      <h6>List group item heading</h6>
      <small className='text-muted mb-2'>3 days ago</small>
    </div>
    <p className='fs-sm font-weight-normals'>Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit. Excepteur sint occaecat cupidatat. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit.</p>
    <small className='text-muted'>Donec id elit non mi porta.</small>
  </ListGroup.Item>
</ListGroup>

Tabs-like behavior

Velit aute mollit ipsum ad dolor consectetur nulla officia culpa adipisicing exercitation fugiat tempor. Voluptate deserunt sit sunt nisi aliqua fugiat proident ea ut. Mollit voluptate reprehenderit occaecat nisi ad non minim tempor sunt voluptate consectetur exercitation id ut nulla. Ea et fugiat aliquip nostrud sunt incididunt consectetur culpa aliquip eiusmod dolor. Anim ad Lorem aliqua in cupidatat nisi enim eu nostrud.
Cupidatat quis ad sint excepteur laborum in esse qui. Et excepteur consectetur ex nisi eu do cillum ad laborum. Mollit et eu officia dolore sunt Lorem culpa qui commodo velit ex amet id ex. Officia anim incididunt laboris deserunt anim aute dolor incididunt veniam aute dolore do exercitation. Dolor nisi culpa ex ad irure in elit eu dolore. Ad laboris ipsum reprehenderit irure non commodo enim culpa commodo veniam.
Ut ut do pariatur aliquip aliqua aliquip exercitation do nostrud commodo reprehenderit aute ipsum voluptate. Irure Lorem et laboris nostrud amet cupidatat cupidatat anim do ut velit mollit consequat enim tempor. Consectetur est minim nostrud nostrud consectetur irure labore voluptate irure. Ipsum id Lorem sit sint voluptate est pariatur eu ad cupidatat et deserunt culpa sit eiusmod deserunt. Consectetur et fugiat anim do eiusmod aliquip nulla laborum elit adipisicing pariatur cillum.
Irure enim occaecat labore sit qui aliquip reprehenderit amet velit. Deserunt ullamco ex elit nostrud ut dolore nisi officia magna sit occaecat laboris sunt dolor. Nisi eu minim cillum occaecat aute est cupidatat aliqua labore aute occaecat ea aliquip sunt amet. Aute mollit dolor ut exercitation irure commodo non amet consectetur quis amet culpa. Quis ullamco nisi amet qui aute irure eu. Magna labore dolor quis ex labore id nostrud deserunt dolor eiusmod eu pariatur culpa mollit in irure.
import Row from 'react-bootstrap/Row'
import Col from 'react-bootstrap/Col'
import ListGroup from 'react-bootstrap/ListGroup'
import Tab from 'react-bootstrap/Tab'

{/* Tabs-like behavior for List group items */}
<Tab.Container defaultActiveKey='#home'>
  <Row className='g-4'>
    <Col md={4}>
      <ListGroup>
        <ListGroup.Item action href='#home'>Home</ListGroup.Item>
        <ListGroup.Item action href='#profile'>Profile</ListGroup.Item>
        <ListGroup.Item action href='#messages'>Messages</ListGroup.Item>
        <ListGroup.Item action href='#settings'>Settings</ListGroup.Item>
      </ListGroup>
    </Col>
    <Col md={8}>
      <Tab.Content>
        <Tab.Pane eventKey='#home'>Velit aute mollit ipsum ad dolor consectetur nulla officia culpa adipisicing exercitation fugiat tempor. Voluptate deserunt sit sunt nisi aliqua fugiat proident ea ut. Mollit voluptate reprehenderit occaecat nisi ad non minim tempor sunt voluptate consectetur exercitation id ut nulla. Ea et fugiat aliquip nostrud sunt incididunt consectetur culpa aliquip eiusmod dolor. Anim ad Lorem aliqua in cupidatat nisi enim eu nostrud.</Tab.Pane>
        <Tab.Pane eventKey='#profile'>Cupidatat quis ad sint excepteur laborum in esse qui. Et excepteur consectetur ex nisi eu do cillum ad laborum. Mollit et eu officia dolore sunt Lorem culpa qui commodo velit ex amet id ex. Officia anim incididunt laboris deserunt anim aute dolor incididunt veniam aute dolore do exercitation. Dolor nisi culpa ex ad irure in elit eu dolore. Ad laboris ipsum reprehenderit irure non commodo enim culpa commodo veniam.</Tab.Pane>
        <Tab.Pane eventKey='#messages'>Ut ut do pariatur aliquip aliqua aliquip exercitation do nostrud commodo reprehenderit aute ipsum voluptate. Irure Lorem et laboris nostrud amet cupidatat cupidatat anim do ut velit mollit consequat enim tempor. Consectetur est minim nostrud nostrud consectetur irure labore voluptate irure. Ipsum id Lorem sit sint voluptate est pariatur eu ad cupidatat et deserunt culpa sit eiusmod deserunt. Consectetur et fugiat anim do eiusmod aliquip nulla laborum elit adipisicing pariatur cillum.</Tab.Pane>
        <Tab.Pane eventKey='#settings'>Irure enim occaecat labore sit qui aliquip reprehenderit amet velit. Deserunt ullamco ex elit nostrud ut dolore nisi officia magna sit occaecat laboris sunt dolor. Nisi eu minim cillum occaecat aute est cupidatat aliqua labore aute occaecat ea aliquip sunt amet. Aute mollit dolor ut exercitation irure commodo non amet consectetur quis amet culpa. Quis ullamco nisi amet qui aute irure eu. Magna labore dolor quis ex labore id nostrud deserunt dolor eiusmod eu pariatur culpa mollit in irure.</Tab.Pane>
      </Tab.Content>
    </Col>
  </Row>
</Tab.Container>