brand brand
Apps
Pages
Documentation
Quickly Build Applications

Exclusively for webapps Based on Bootstrap

Go Appster

List group

List groups are a flexible and powerful component for displaying a series of content.

Basic List

The most basic list group is an unordered list with list items and the proper classes. Add .active & .disabled classes for states.

  • Regular list group item
  • Active list group item
  • Disabled list group item
														
<ul class="list-group">
	<li class="list-group-item">Regular list group item</li>
	<li class="list-group-item active">Active list group item</li>
	<li class="list-group-item disabled">Disabled list group item</li>
</ul>
Flush

Add .list-group-flush to remove some borders and rounded corners to render list group items edge-to-edge in a parent container.

  • Regular list group item
  • Active list group item
  • Disabled list group item
														
<ul class="list-group list-group-flush">
	<li class="list-group-item active">Regular list group item</li>
	<li class="list-group-item">Active list group item</li>
	<li class="list-group-item disabled">Disabled list group item</li>
</ul>
Contextual classes

Use contextual classes to style list items with a stateful background and color.

  • This is a regular list group item
  • This is a primary list group item
  • This is a secondary list group item
  • This is a success list group item
  • This is a danger list group item
  • This is a warning list group item
  • This is a info list group item
  • This is a light list group item
  • This is a dark list group item
														
<ul class="list-group">
	<li class="list-group-item">This is a regular list group item</li>
	<li class="list-group-item list-group-item-primary">This is a primary list group item</li>
	<li class="list-group-item list-group-item-secondary">This is a secondary list group item</li>
	<li class="list-group-item list-group-item-success">This is a success list group item</li>
	<li class="list-group-item list-group-item-danger">This is a danger list group item</li>
	<li class="list-group-item list-group-item-warning">This is a warning list group item</li>
	<li class="list-group-item list-group-item-info">This is a info list group item</li>
	<li class="list-group-item list-group-item-light">This is a light list group item</li>
	<li class="list-group-item list-group-item-dark">This is a dark list group item</li>
</ul>
Class Values
class="list-group-item list-group-item-[Value]" primary / success / warning / danger / info / light / dark / red / green / pink / purple / violet / indigo / blue / sky / cyan / teal / neon / lime / sun / yellow / orange / pumpkin / brown / grey / gold / smoke
Contextual classes inverse

Use .list-group-inv .list-group-inv-* to change the appearance of list group items.

  • This is a regular list group item
  • This is a primary list group item
  • This is a secondary list group item
  • This is a success list group item
  • This is a danger list group item
  • This is a warning list group item
  • This is a info list group item
														
<ul class="list-group">
	<li class="list-group-item">This is a regular list group item</li>
	<li class="list-group-item list-group-inv list-group-inv-primary">This is a primary list group item</li>
	<li class="list-group-item list-group-inv list-group-inv-secondary">This is a secondary list group item</li>
	<li class="list-group-item list-group-inv list-group-inv-success">This is a success list group item</li>
	<li class="list-group-item list-group-inv list-group-inv-danger">This is a danger list group item</li>
	<li class="list-group-item list-group-inv list-group-inv-warning">This is a warning list group item</li>
	<li class="list-group-item list-group-inv list-group-inv-info">This is a info list group item</li>
</ul>
Class Values
class="list-group-item list-group-item--inv-[Value]" primary / success / warning / danger / info / light / dark / red / green / pink / purple / violet / indigo / blue / sky / cyan / teal / neon / lime / sun / yellow / orange / pumpkin / brown / grey / gold / smoke
Horizontal

Add .list-group-horizontal to change the layout of list group items from vertical to horizontal across all breakpoints.

  • An item
  • A second item
  • A third item
  • An item
  • A second item
  • A third item
  • An item
  • A second item
  • A third item
  • An item
  • A second item
  • A third item
  • An item
  • A second item
  • A third item
  • An item
  • A second item
  • A third item
														
<ul class="list-group list-group-horizontal">
	<li class="list-group-item">An item</li>
	<li class="list-group-item">A second item</li>
	<li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-sm">
	<li class="list-group-item">An item</li>
	<li class="list-group-item">A second item</li>
	<li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-md">
	<li class="list-group-item">An item</li>
	<li class="list-group-item">A second item</li>
	<li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-lg">
	<li class="list-group-item">An item</li>
	<li class="list-group-item">A second item</li>
	<li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-xl">
	<li class="list-group-item">An item</li>
	<li class="list-group-item">A second item</li>
	<li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-xxl">
	<li class="list-group-item">An item</li>
	<li class="list-group-item">A second item</li>
	<li class="list-group-item">A third item</li>
</ul>
With badges

Add badges to any list group item to show unread counts, activity, and more with the help of some flex utilities.

  • List group item one 14
  • List group item two 2
  • List group item three 1 
														
<ul class="list-group">
	<li class="list-group-item d-flex justify-content-between align-items-center">
		List group item one
		<span class="badge badge-primary badge-pill">14</span>
	</li>
	<li class="list-group-item d-flex justify-content-between align-items-center">
		List group item two
		<span class="badge badge-primary badge-pill">2</span>
	</li>
	<li class="list-group-item d-flex justify-content-between align-items-center">
		List group item three
		<span class="badge badge-primary badge-pill">1</span>
	</li>
</ul>
Links and buttons

Use anchor or button tag to create actionable list group items with hover, disabled, and active states by adding .list-group-item-action.

Link list group item 
														
<div class="list-group">
	<button type="button" class="list-group-item list-group-item-action active">
		Button list group item
	</button>
	<a href="#" class="list-group-item list-group-item-action">Link list group item</a>
</div>
Custom content

Add nearly any HTML within, even for linked list groups like the one below, with the help of flexbox utilities.

														
<div class="list-group">
	<a href="#" class="list-group-item list-group-item-action flex-column align-items-start active">
		<div class="d-flex w-100 justify-content-between">
			<h5 class="mb-1">List group item heading</h5>
			<small>3 days ago</small>
		</div>
		<p class="mb-1">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
		<small>Donec id elit non mi porta.</small>
	</a>
	<a href="#" class="list-group-item list-group-item-action flex-column align-items-start">
		<div class="d-flex w-100 justify-content-between">
			<h5 class="mb-1">List group item heading</h5>
			<small class="text-muted">3 days ago</small>
		</div>
		<p class="mb-1">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
		<small class="text-muted">Donec id elit non mi porta.</small>
	</a>
	<a href="#" class="list-group-item list-group-item-action flex-column align-items-start">
		<div class="d-flex w-100 justify-content-between">
			<h5 class="mb-1">List group item heading</h5>
			<small class="text-muted">3 days ago</small>
		</div>
		<p class="mb-1">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
		<small class="text-muted">Donec id elit non mi porta.</small>
	</a>
</div>
With icons

Add Icons with list groups

  • List group item one
  • List group item two
  • List group item three
  • List group item one 12
  • List group item two 10
  • List group item three 1 
														
<div class="row">
	<div class="col-md-6 m-md-0 mb-3">
		<ul class="list-group">
			<li class="list-group-item d-flex justify-content-between align-items-center">
				List group item one
				<i class="las la-exclamation-circle text-light fs-4"></i>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				List group item two
				<i class="las la-las la-user text-light fs-4"></i>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				List group item three
				<i class="las la-bell text-light fs-4"></i>
			</li>
		</ul>
	</div>
	<div class="col-md-6">
		<ul class="list-group">
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<span class="d-flex"><i class="las la-exclamation-circle  fs-4 text-light me-2"></i>List group item one</span>
				<span>12</span>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<span class="d-flex"><i class="las la-las la-user  fs-4 text-light me-2"></i>List group item two</span>
				<span>10</span>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<span class="d-flex"><i class="las la-bell  fs-4 text-light me-2"></i>List group item three</span>
				<span>1</span>
			</li>
		</ul>
	</div>
</div>
With checkbox

Place Bootstrap’s checkboxes and radios within list group items and customize as needed.

  • 12
  • 10
  • 15
  • 12
  • 10
  • 15 
														
<div class="row">
	<div class="col-md-6 m-md-0 mb-3">
		<ul class="list-group">
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<div class="form-check">
					<input type="checkbox" class="form-check-input" checked id="customCheck1">
					<label class="form-check-label" for="customCheck1">Check this custom checkbox</label>
				</div>
				<span>12</span>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<div class="form-check">
					<input type="checkbox" class="form-check-input" id="customCheck2">
					<label class="form-check-label" for="customCheck2">Check this custom checkbox</label>
				</div>
				<span>10</span>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<div class="form-check">
					<input type="checkbox" class="form-check-input" id="customChkDisabled" disabled>
					<label class="form-check-label" for="customChkDisabled">Check this custom checkbox</label>
				</div>
				<span>15</span>
			</li>
		</ul>
	</div>
	<div class="col-md-6">
		<ul class="list-group">
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<div class="form-check">
					<input type="radio" id="customRadio1" name="customRadio" checked class="form-check-input">
					<label class="form-check-label" for="customRadio1">Toggle this custom radio</label>
				</div>
				<span>12</span>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<div class="form-check">
					<input type="radio" id="customRadio2" name="customRadio" class="form-check-input">
					<label class="form-check-label" for="customRadio2">Or toggle this other custom radio</label>
				</div>
				<span>10</span>
			</li>
			<li class="list-group-item d-flex justify-content-between align-items-center">
				<div class="form-check">
					<input type="radio" name="radioDisabled" id="customRadioDisabled" class="form-check-input" disabled>
					<label class="form-check-label" for="customRadioDisabled">Toggle this custom radio</label>
				</div>
				<span>15</span>
			</li>
		</ul>
	</div>
</div>
JavaScript behavior

Use the tab JavaScript plugin—include it individually or through the compiled bootstrap.js file—to extend our list group to create tabbable panes of local content.

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 do aliquip veniam minim.

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 incididunt veniam ad.

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.

														
<div class="row">
	<div class="col-4">
		<div class="list-group" id="list-tab" role="tablist">
			<a class="list-group-item list-group-item-action active" id="list-home-list" data-bs-toggle="list" href="#list-home" role="tab" aria-controls="list-home">Home</a>
			<a class="list-group-item list-group-item-action" id="list-profile-list" data-bs-toggle="list" href="#list-profile" role="tab" aria-controls="list-profile">Profile</a>
			<a class="list-group-item list-group-item-action" id="list-messages-list" data-bs-toggle="list" href="#list-messages" role="tab" aria-controls="list-messages">Messages</a>
			<a class="list-group-item list-group-item-action" id="list-settings-list" data-bs-toggle="list" href="#list-settings" role="tab" aria-controls="list-settings">Settings</a>
		</div>
	</div>
	<div class="col-8">
		<div class="tab-content" id="nav-tabContent">
			<div class="tab-pane fade show active" id="list-home" role="tabpanel" aria-labelledby="list-home-list">
				<p>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 do aliquip veniam minim.</p>
			</div>
			<div class="tab-pane fade" id="list-profile" role="tabpanel" aria-labelledby="list-profile-list">
				<p>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 incididunt veniam ad.</p>
			</div>
			<div class="tab-pane fade" id="list-messages" role="tabpanel" aria-labelledby="list-messages-list">
				<p>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.</p>
			</div>
			<div class="tab-pane fade" id="list-settings" role="tabpanel" aria-labelledby="list-settings-list">
				<p>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.</p>
			</div>
		</div>
	</div>
</div>
Numbered

Add the .list-group-numbered modifier class (and optionally use an <ol> element) to opt into numbered list group items. Numbers are generated via CSS (as opposed to a <ol>s default browser styling) for better placement inside list group items and to allow for better customization.

  1. Cras justo odio
  2. Cras justo odio
  3. Cras justo odio
														
<ol class="list-group list-group-numbered">
	<li class="list-group-item">Cras justo odio</li>
	<li class="list-group-item">Cras justo odio</li>
	<li class="list-group-item">Cras justo odio</li>
</ol>
Jump to