Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages.

Examples

Wrap any text and an optional dismiss button in .alert and one of the four contextual classes (e.g., .alert-success) for basic alert messages.

No default class

Alerts don't have default classes, only base and modifier classes. A default gray alert doesn't make too much sense, so you're required to specify a type via contextual class. Choose from success, info, warning, or danger.

Well done! You successfully read this important alert message.

Heads up! This alert needs your attention, but it's not super important.

Warning! Better check yourself, you're not looking too good.

Oh snap! Change a few things up and try submitting again.

<div class="alert alert-success" role="alert">...</div>
<div class="alert alert-info" role="alert">...</div>
<div class="alert alert-warning" role="alert">...</div>
<div class="alert alert-danger" role="alert">...</div>

Dismissible alerts

Build on any alert by adding an optional .alert-dismissible and close button.

Requires JavaScript alert plugin

For fully functioning, dismissible alerts, you must use the alerts JavaScript plugin.

Warning! Better check yourself, you're not looking too good.

<div class="alert alert-warning alert-dismissible" role="alert">
  <button type="button" class="close" data-dismiss="alert" aria-label="Close"><span aria-hidden="true">&times;</span></button>
  <strong>Warning!</strong> Better check yourself, you're not looking too good.
</div>

Ensure proper behavior across all devices

Be sure to use the <button> element with the data-dismiss="alert" data attribute.

Connecting alerts

Use the .arrow classes to visually attach alerts to other elements.

Well done! You successfully read this important alert message.

Heads up! This alert needs your attention, but it's not super important.

Warning! Better check yourself, you're not looking too good.

<div class="alert alert-success arrow" role="alert">...</div>
<div class="alert alert-info arrow arrow-right" role="alert">...</div>
<div class="alert alert-warning arrow arrow-bottom arrow-center" role="alert">...</div>

Links in alerts

Use the .alert-link utility class to quickly provide matching colored links within any alert.

Well done! You successfully read this important alert message.

Heads up! This alert needs your attention, but it's not super important.

Warning! Better check yourself, you're not looking too good.

Oh snap! Change a few things up and try submitting again.

<div class="alert alert-success" role="alert">
  <a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-info" role="alert">
  <a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-warning" role="alert">
  <a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-danger" role="alert">
  <a href="#" class="alert-link">...</a>
</div>

Easily highlight new or unread items by adding a <span class="badge"> to links, Bootstrap navs, and more.

Inbox 42

<a href="#">Inbox <span class="badge">42</span></a>

<button class="btn btn-primary" type="button">
  Messages <span class="badge">4</span>
</button>

Color

Use .badge-success contextual class.

Inbox new

<a href="#">Inbox <span class="badge badge-success">new</span></a>

Navigation Icon

Use .icon +.badge contextual class. It's responsive to handle inverse case.

<nav class="navbar navbar-default m-b-0 simple-nav">
  <ul class="nav navbar-nav">
    <li class="m-r-0">
      <a class="p-r-0">
        <span class="icon icon-notification m-r-0"></span>
        <span class="badge">20</span>
      </a>
    </li>
  </ul>
</nav>

Self collapsing

When there are no new or unread items, badges will simply collapse (via CSS's :empty selector) provided no content exists within.

Cross-browser compatibility

Badges won't self collapse in Internet Explorer 8 because it lacks support for the :empty selector.

Adapts to active nav states

Built-in styles are included for placing badges in active states in pill navigations.

<ul class="nav nav-pills" role="tablist">
  <li role="presentation" class="active"><a href="#">Home <span class="badge">42</span></a></li>
  <li role="presentation"><a href="#">Profile</a></li>
  <li role="presentation"><a href="#">Messages <span class="badge">3</span></a></li>
</ul>

Breadcrumbs

Indicate the current page's location within a navigational hierarchy.

Separators are automatically added in CSS through :before and content.

<ol class="breadcrumb">
  <li><a href="#">Home</a></li>
  <li><a href="#">Library</a></li>
  <li class="active">Data</li>
</ol>

Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.

Plugin dependency

Button dropdowns require the dropdown plugin to be included in your version of Bootstrap.

Single button dropdowns

Turn a button into a dropdown toggle with some basic markup changes.

<!-- Single button -->
<div class="btn-group">
  <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-expanded="false">
    Action <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
    <li class="divider"></li>
    <li><a href="#">Separated link</a></li>
  </ul>
</div>

Input button dropdowns

We also use our button dropdown styles to provide a stylised select box.

Bootstrap simply supplies the required styles. A full implementation for Angular 1.X can be found in our styleguide-components.

<!-- Regular dropdown -->
<div class="btn-group btn-block">
  <button type="button" class="btn btn-input dropdown-toggle"
    data-toggle="dropdown" aria-expanded="false">
    <span class="form-control-placeholder">Select an option...</span>
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu">
    <li class="active"><a href="#">Option 1</a></li>
    <li><a href="#">Option 2</a></li>
    <li><a href="#">Option 3</a></li>
  </ul>
</div>

<!-- Inverse dropdown -->
<div class="btn-group btn-block">
  <button type="button" class="btn btn-input btn-input-inverse dropdown-toggle"
    data-toggle="dropdown" aria-expanded="false">
    <span class="form-control-placeholder">Select an option...</span>
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu">
    ...
  </ul>
</div>

Split button dropdowns

Similarly, create split button dropdowns with the same markup changes, only with a separate button.

<!-- Split button -->
<div class="btn-group">
  <button type="button" class="btn btn-danger">Action</button>
  <button type="button" class="btn btn-danger dropdown-toggle" data-toggle="dropdown" aria-expanded="false">
    <span class="caret"></span>
    <span class="sr-only">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu" role="menu">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
    <li class="divider"></li>
    <li><a href="#">Separated link</a></li>
  </ul>
</div>

Sizing

Button dropdowns work with buttons of all sizes.

<!-- Large button group -->
<div class="btn-group">
  <button class="btn btn-default btn-lg dropdown-toggle" type="button" data-toggle="dropdown" aria-expanded="false">
    Large button <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu">
    ...
  </ul>
</div>

<!-- Small button group -->
<div class="btn-group">
  <button class="btn btn-default btn-sm dropdown-toggle" type="button" data-toggle="dropdown" aria-expanded="false">
    Small button <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu">
    ...
  </ul>
</div>

<!-- Extra small button group -->
<div class="btn-group">
  <button class="btn btn-default btn-xs dropdown-toggle" type="button" data-toggle="dropdown" aria-expanded="false">
    Extra small button <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu">
    ...
  </ul>
</div>

Dropup variation

Trigger dropdown menus above elements by adding .dropup to the parent.

<div class="btn-group dropup">
  <button type="button" class="btn btn-default">Dropup</button>
  <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-expanded="false">
    <span class="caret"></span>
    <span class="sr-only">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu" role="menu">
    <!-- Dropdown menu links -->
  </ul>
</div>

Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with our buttons plugin.

Tooltips & popovers in button groups require special setting

When using tooltips or popovers on elements within a .btn-group, you'll have to specify the option container: 'body' to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).

Ensure correct `role` and provide a label

In order for assistive technologies – such as screen readers – to convey that a series of buttons is grouped, an appropriate role attribute needs to be provided. For button groups, this would be role="group", while toolbars should have a role="toolbar".

One exception are groups which only contain a single control (for instance the justified button groups with <button> elements) or a dropdown.

In addition, groups and toolbars should be given an explicit label, as most assistive technologies will otherwise not announce them, despite the presence of the correct role attribute. In the examples provided here, we use aria-label, but alternatives such as aria-labelledby can also be used.

Basic example

Wrap a series of buttons with .btn in .btn-group.

<div class="btn-group" role="group" aria-label="...">
  <button type="button" class="btn btn-default">Left</button>
  <button type="button" class="btn btn-default">Middle</button>
  <button type="button" class="btn btn-default">Right</button>
</div>

Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.

<div class="btn-toolbar btn-toolbar-sm" role="toolbar" aria-label="...">
  <div class="btn-group" role="group" aria-label="...">...</div>
  <div class="btn-group" role="group" aria-label="...">...</div>
  <button type="button" class="btn btn-default">...</button>
</div>

Button toolbar collapse

.btn-toolbar collapses to use full-width buttons on smaller screens. Use modifier classes to adjust the breakpoint beneath which the tollbar collapses.

<div class="btn-toolbar btn-toolbar-sm" role="toolbar" aria-label="...">...</div>
<div class="btn-toolbar btn-toolbar-md" role="toolbar" aria-label="...">...</div>
<div class="btn-toolbar btn-toolbar-lg" role="toolbar" aria-label="...">...</div>
<div class="btn-toolbar btn-toolbar-xl" role="toolbar" aria-label="...">...</div>

Sizing

Instead of applying button sizing classes to every button in a group, just add .btn-group-* to each .btn-group, including when nesting multiple groups.

<div class="btn-group btn-group-lg" role="group" aria-label="...">...</div>
<div class="btn-group" role="group" aria-label="...">...</div>
<div class="btn-group btn-group-sm" role="group" aria-label="...">...</div>
<div class="btn-group btn-group-xs" role="group" aria-label="...">...</div>

Nesting

Place a .btn-group within another .btn-group when you want dropdown menus mixed with a series of buttons.

<div class="btn-group" role="group" aria-label="...">
  <button type="button" class="btn btn-default">1</button>
  <button type="button" class="btn btn-default">2</button>

  <div class="btn-group" role="group">
    <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-expanded="false">
      Dropdown
      <span class="caret"></span>
    </button>
    <ul class="dropdown-menu" role="menu">
      <li><a href="#">Dropdown link</a></li>
      <li><a href="#">Dropdown link</a></li>
    </ul>
  </div>
</div>

Vertical variation

Make a set of buttons appear vertically stacked rather than horizontally. Split button dropdowns are not supported here.

<div class="btn-group-vertical" role="group" aria-label="...">
  ...
</div>

Justified button groups

Make a group of buttons stretch at equal sizes to span the entire width of its parent. Also works with button dropdowns within the button group.

Handling borders

Due to the specific HTML and CSS used to justify buttons (namely display: table-cell), the borders between them are doubled. In regular button groups, margin-left: -1px is used to stack the borders instead of removing them. However, margin doesn't work with display: table-cell. As a result, depending on your customizations to Bootstrap, you may wish to remove or re-color the borders.

IE8 and borders

Internet Explorer 8 doesn't render borders on buttons in a justified button group, whether it's on <a> or <button> elements. To get around that, wrap each button in another .btn-group.

See #12476 for more information.

With `<a>` elements

Just wrap a series of .btns in .btn-group.btn-group-justified.

Left Middle Right

Left Middle

<div class="btn-group btn-group-justified" role="group" aria-label="...">
  ...
</div>

Links acting as buttons

If the <a> elements are used to act as buttons – triggering in-page functionality, rather than navigating to another document or section within the current page – they should also be given an appropriate role="button".

With `<button>` elements

To use justified button groups with <button> elements, you must wrap each button in a button group. Most browsers don't properly apply our CSS for justification to <button> elements, but since we support button dropdowns, we can work around that.

<div class="btn-group btn-group-justified" role="group" aria-label="...">
  <div class="btn-group" role="group">
    <button type="button" class="btn btn-default">Left</button>
  </div>
  <div class="btn-group" role="group">
    <button type="button" class="btn btn-default">Middle</button>
  </div>
  <div class="btn-group" role="group">
    <button type="button" class="btn btn-default">Right</button>
  </div>
</div>

Circles are used to add visual interest to body text, they often help to represent steps in a process or to accompany a set of discrete points. Circles may contain images, iconography or letters, and are generally central in their column, or used as avatars, left-aligned in lists.

AZ

<div class="circle">
  <i class="glyphicon glyphicon-globe"></i>
</div>
<div href="..." class="circle">
  <i class="icon icon-card"></i>
</div>
<div class="circle">
  AZ
</div>
<img class="circle" src="..." alt="..." />
<div class="circle" style="background-image: url('...');"></div>

Size variations

Add any of the below modifier classes to change the size of a circle. Nest circles in links to gain hover states.

AZ

<a class="circle circle-lg">...</a>
<a href="...">
  <img class="circle circle-md" src="..." />
</a>
<a class="circle circle-sm">...</a>
<a class="circle circle-xs">...</a>

Inverse circles

There are two styling variants. If you are using a circle on a white background use the .circle-inverse class to apply a contrasting background.

AZ

<a class="circle circle-sm circle-inverse">...</a>

Responsive circles

The responsive circle variant decreases in size on smaller screen widths, the md circle takes the size of an sm, and the lg variant takes on the size of an md. Simply add the .circle-responsive class.

AZ

<div class="circle circle-lg circle-inverse circle-responsive">...</div>
<div class="circle circle-md circle-inverse circle-responsive">...</div>

Backgrounds are applied to box elements. This could be a grid column, a page width block, or something custom.

The size is based on the width of the container. It is slightly larger than the container to make sure content has a background.

Defaults

By default it is centered both vertically and horizontally on the box and not clipped by the edge of the box.

Default circle

  <div class="circle-bg">
    ...
  </div>

Sizes

Size modifiers do not move the centre of the circle, they just alter the size.

Example logic:

xs: 0.25 * width
sm: 0.5 * wisdth
md: 1.2 * width (default)
lg: 2 * width
xl: 4 * width

xs

sm

md

lg

xl

  <div class="circle-bg circle-bg-xs">
    ...
  </div>
  <div class="circle-bg circle-bg-sm">
    ...
  </div>
  <div class="circle-bg">
    ...
  </div>
  <div class="circle-bg circle-bg-lg">
    ...
  </div>
  <div class="circle-bg circle-bg-xl">
    ...
  </div>

Positions (center)

The centre of the circle is moved just outside the edge of the container box.

We can use modifier classes to choose the edge.

Top
Right
Bottom
Left

We can also use these in x/y combinations.

Top

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

right

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

bottom

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

  <div class="circle-bg circle-bg-top-c">
    ...
  </div>
  <div class="circle-bg circle-bg-right-c">
    ...
  </div>
  <div class="circle-bg circle-bg-bottom-c">
    ...
  </div>
  <div class="circle-bg circle-bg-left-c">
    ...
  </div>

Position (center) x/y combinations

top left

Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Minus,

Top Right

Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Bottom Left

Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Bottom Right

Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consectetur adipisicing elit.

  <div class="circle-bg circle-bg-top-c circle-bg-left-c">
    ...
  </div>
  <div class="circle-bg circle-bg-top-c circle-bg-right-c">
    ...
  </div>
  <div class="circle-bg circle-bg-bottom-c circle-bg-left-c">
    ...
  </div>
  <div class="circle-bg circle-bg-bottom-c circle-bg-top-c">
    ...
  </div>

Position (box edge)

The edge of the circle is moved just outside of the edge of the container box.

Modifiers:

Top
Right
Bottom
Left

We can also use these in x/y combinations.

Top

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus

Right

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus

Bottom

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus

Left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

  <div class="circle-bg circle-bg-top">
    ...
  </div>
  <div class="circle-bg circle-bg-right">
    ...
  </div>
  <div class="circle-bg circle-bg-bottom">
    ...
  </div>
  <div class="circle-bg circle-bg-left">
    ...
  </div>

Position (box edge) x/y combinations

Top Left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus Lorem ipsum dolor sit amet, consectetur adipisicing elit. Incidunt voluptas, cupiditate et blanditiis hic, alias consectetur

Top Right

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus Lorem ipsum dolor sit amet, consectetur adipisicing elit. Incidunt voluptas, cupiditate et blanditiis hic, alias consectetur

Bottom Left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus Lorem ipsum dolor sit amet, consectetur adipisicing elit. Incidunt voluptas, cupiditate et blanditiis hic, alias consectetur

Bottom Right

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus Lorem ipsum dolor sit amet, consectetur adipisicing elit. Incidunt voluptas, cupiditate et blanditiis hic, alias consectetur

  <div class="circle-bg circle-bg-top circle-bg-left">
    ...
  </div>
  <div class="circle-bg circle-bg-top circle-bg-right">
    ...
  </div>
  <div class="circle-bg circle-bg-bottom circle-bg-left">
    ...
  </div>
  <div class="circle-bg circle-bg-bottom circle-bg-right">
    ...
  </div>

Size and positions

We can use these together for different effects.

xs top right

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi ad omnis esse accusantium harum veniam, ex in numquam accusamus commodi suscipit corrupti modi illum est quod.

sm bottom right

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

md bottom left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Natus minus animi a labore. Ipsam autem similique culpa, optio vero, reiciendis nesciunt, odio, laborum adipisci obcaecati labore dolores quasi.

    <div class="circle-bg circle-bg-xs circle-bg-top circle-bg-right">
      ...
    </div>
    <div class="circle-bg circle-bg-sm circle-bg-bottom circle-bg-right">
      ...
    </div>
    <div class="circle-bg circle-bg-bottom circle-bg-left">
      ...
    </div>

If we want to mostly cover the background of the box, but with an offset style, we could use the lg variant (2x width) and side positioning.

lg bottom left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Sapiente quisquam velit perferendis sed. Et consectetur repudiandae dolore quibusdam unde ea, assumenda id non consequuntur, minima ducimus. Eos iure atque voluptatem culpa sunt fugiat modi doloribus vitae aliquid illo reiciendis et

    <div class="circle-bg circle-bg-lg circle-bg-bottom circle-bg-left">
      ...
    </div>

xl left

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quos consequatur repellat nihil eaque doloribus assumenda accusantium laborum perferendis amet suscipit. Fugiat fuga amet beatae id eaque sapiente, ipsa assumenda soluta, ex dolorum.

    <div class="circle-bg circle-bg-xl circle-bg-left">
      ...
    </div>

Clipping boxes

Sometime we want to clip the circle, we should do this with a clipping box at a higher level.

Clip

lg left

  <div class="circle-bg-clip">
    <div class="col-xs-6">
      Clip
    </div>
    <div class="col-xs-6">
      <div class="circle-bg circle-bg-lg circle-bg-left">
        lg left
      </div>
    </div>
  </div>

Colours

We need several colour modifiers for our regular background colours:

Light grey (for use on white)
Light blue (for use on white)
Dark navy blue (for use on light navy blue)
Light navy blue (for use on white)

Some text

Default color

Some text

Light blue

Some text

Navy blue

Some text

Dark navy blue

Navy blue

Dark navy blue

  <div class="circle-bg">
    Default color
  </div>
  <div class="circle-bg circle-bg-light-blue">
    Light blue
  </div>
  <div class="circle-bg circle-bg-blue">
    Navy blue
  </div>
  <div class="circle-bg circle-bg-navy">
    Dark navy blue
  </div>

There are available utility clases to control the vertical margin of the circle background element.

  .circle-bg-xs-margin
  .circle-bg-sm-margin
  .circle-bg-margin
  .circle-bg-lg-margin
  .circle-bg-xl-margin

Toggleable, contextual menu for displaying lists of links. Made interactive with the dropdown JavaScript plugin.

Example

Wrap the dropdown's trigger and the dropdown menu within .dropdown, or another element that declares position: relative;. Then add the menu's HTML.

<div class="dropdown">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-expanded="true">
    Dropdown
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Action</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another action</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Something else here</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Separated link</a></li>
  </ul>
</div>

Dropdown menus can be changed to expand upwards (instead of downwards) by adding .dropup to the parent.

<div class="dropup">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu2" data-toggle="dropdown" aria-expanded="true">
    Dropup
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu2">
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Action</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another action</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Something else here</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Separated link</a></li>
  </ul>
</div>

Alignment

By default, a dropdown menu is automatically positioned 100% from the top and along the left side of its parent. Add .dropdown-menu-right to a .dropdown-menu to right align the dropdown menu.

<ul class="dropdown-menu dropdown-menu-right" role="menu" aria-labelledby="dLabel">
  ...
</ul>

Headers

Add a header to label sections of actions in any dropdown menu.

<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu3">
  ...
  <li role="presentation" class="dropdown-header">Dropdown header</li>
  ...
</ul>

Divider

Add a divider to separate series of links in a dropdown menu.

<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenuDivider">
  ...
  <li role="presentation" class="divider"></li>
  ...
</ul>

Disabled menu items

Add .disabled to a <li> in the dropdown to disable the link.

<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu4">
  <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Regular link</a></li>
  <li role="presentation" class="disabled"><a role="menuitem" tabindex="-1" href="#">Disabled link</a></li>
  <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another link</a></li>
</ul>

Droppable is a set of styles for a drag and drop form component. An implementation can be found in our styleguide-components repository.

Drag and drop a .CSV file less than 5MB

<div class="droppable droppable-md">
  <div class="droppable-card-content">
    <div class="m-b-2">
      <i class="icon icon-upload icon-xxl"></i>
    </div>
    <p class="m-b-2">Drag and drop a .CSV file less than 5MB</p>
    <button class="btn btn-primary">Or select file</button>
  </div>
</div>

Droppable cards

The various states of the droppable component are contained within cards for each state. The visibility and transitions between states are managed by modifier classes.

There are four cards and corresponding states:

.droppable-default-card is used for the default state, it is enabled when none of the other states is present. The default card determines the height of the component so be sure to include enough content to make sure the component can accomodate the other cards.
.droppable-droppping is used when a file is eligible to be dropped on the component, it enables the .droppable-dropping-card.
.droppable-processing is used when we're processing the upload or sending a file to the server. It enables the .droppable-processing-card.
.droppable-complete is used when processing is complete, it enables the .droppable-processing-card.

Within the card use .droppable-card-content to vertically centre the content.

Drag and drop a .CSV file less than 5MB

Drop file to start upload

Drag and drop a .CSV file less than 5MB

Uploading

Drag and drop a .CSV file less than 5MB

Upload complete!

css.png

Choose a different file?

<div class="droppable droppable-md">
  <div class="droppable-default-card">
    <div class="droppable-card-content">
      ...
    </div>
  </div>
</div>
<div class="droppable droppable-md droppable-dropping">
  <div class="droppable-dropping-card">
    <div class="droppable-card-content">
      ...
    </div>
  </div>
</div>
<div class="droppable droppable-md droppable-processing">
  <div class="droppable-processing-card">
    <div class="droppable-card-content">
      ...
    </div>
  </div>
</div>
<div class="droppable droppable-md droppable-complete">
  <div class="droppable-complete-card">
    <div class="droppable-card-content">
      ...
    </div>
  </div>
</div>

Droppable states

As you add and remove the droppable states the cards will animate in and out with appropriate transitions.

Drag and drop a .CSV file less than 5MB

Drop file to start upload

Uploading

Upload complete!

css.png

Choose a different file?

Default Dropping Processing Complete

<div class="droppable droppable-lg">
  <div class="droppable-default-card droppable-card">...</div>
  <div class="droppable-dropping-card droppable-card">...</div>
  <div class="droppable-processing-card droppable-card">...</div>
  <div class="droppable-complete-card droppable-card">...</div>
</div>

Size variants

Depending on the column you are using your droppable component within, you may wish to use a different size variant. Full width UIs will likely use the large variant .droppable-lg, whereas a UI asking for multiple uploads (e.g. the front and back of a document) may use the smaller variant .droppable-sm in a column layout.

Drag and drop a .CSV file less than 5MB

Upload .CSV file less than 5MB

Drag and drop a .CSV file less than 5MB

Upload .CSV file less than 5MB

Drag and drop a .CSV file less than 5MB

Upload .CSV file less than 5MB

<div class="row">
  <div class="col-sm-6 col-md-4">
    <div class="droppable droppable-sm">
      ...
    </div>
  </div>
</div>
<div class="row">
  <div class="col-sm-8 col-md-6">
    <div class="droppable droppable-md">
      ...
    </div>
  </div>
</div>
<div class="row">
  <div class="col-xs-12">
    <div class="droppable droppable-lg">
      ...
    </div>
  </div>
</div>

Global footer for all web products.

Use .footer-title class to block titles.

Use .footer-link class to links.

Add .p-y-section-5 class (or similar) to footer section to give proper responsive spacing to the footer.

Use .tiny utility class to the copyright copy.

<footer class="footer p-y-section-5">
  <div class="container">
    <div class="row">
    ...
    <h5 class="footer-title">I am a title</h5>
    <a class="footer-link" href="">I am a link</a>
    ...
    </div>
    <hr>
    <div class="row">
      <p class="tiny">© TransferWise Ltd <span>2018</span></p>
    </div>
  </div>
</footer>

Add .footer-inverse class to the footer element.

<footer class="footer footer-inverse p-y-section-5">
  ...
</footer>

Available glyphs

Includes over 250 glyphs in font format from the Glyphicon Halflings set. Glyphicons Halflings are normally not available for free, but their creator has made them available for Bootstrap free of cost. As a thank you, we only ask that you include a link back to Glyphicons whenever possible.

glyphicon glyphicon-asterisk
glyphicon glyphicon-plus
glyphicon glyphicon-euro
glyphicon glyphicon-eur
glyphicon glyphicon-minus
glyphicon glyphicon-cloud
glyphicon glyphicon-envelope
glyphicon glyphicon-pencil
glyphicon glyphicon-glass
glyphicon glyphicon-music
glyphicon glyphicon-search
glyphicon glyphicon-heart
glyphicon glyphicon-star
glyphicon glyphicon-star-empty
glyphicon glyphicon-user
glyphicon glyphicon-film
glyphicon glyphicon-th-large
glyphicon glyphicon-th
glyphicon glyphicon-th-list
glyphicon glyphicon-ok
glyphicon glyphicon-remove
glyphicon glyphicon-zoom-in
glyphicon glyphicon-zoom-out
glyphicon glyphicon-off
glyphicon glyphicon-signal
glyphicon glyphicon-cog
glyphicon glyphicon-trash
glyphicon glyphicon-home
glyphicon glyphicon-file
glyphicon glyphicon-time
glyphicon glyphicon-road
glyphicon glyphicon-download-alt
glyphicon glyphicon-download
glyphicon glyphicon-upload
glyphicon glyphicon-inbox
glyphicon glyphicon-play-circle
glyphicon glyphicon-repeat
glyphicon glyphicon-refresh
glyphicon glyphicon-list-alt
glyphicon glyphicon-lock
glyphicon glyphicon-flag
glyphicon glyphicon-headphones
glyphicon glyphicon-volume-off
glyphicon glyphicon-volume-down
glyphicon glyphicon-volume-up
glyphicon glyphicon-qrcode
glyphicon glyphicon-barcode
glyphicon glyphicon-tag
glyphicon glyphicon-tags
glyphicon glyphicon-book
glyphicon glyphicon-bookmark
glyphicon glyphicon-print
glyphicon glyphicon-camera
glyphicon glyphicon-font
glyphicon glyphicon-bold
glyphicon glyphicon-italic
glyphicon glyphicon-text-height
glyphicon glyphicon-text-width
glyphicon glyphicon-align-left
glyphicon glyphicon-align-center
glyphicon glyphicon-align-right
glyphicon glyphicon-align-justify
glyphicon glyphicon-list
glyphicon glyphicon-indent-left
glyphicon glyphicon-indent-right
glyphicon glyphicon-facetime-video
glyphicon glyphicon-picture
glyphicon glyphicon-map-marker
glyphicon glyphicon-adjust
glyphicon glyphicon-tint
glyphicon glyphicon-edit
glyphicon glyphicon-share
glyphicon glyphicon-check
glyphicon glyphicon-move
glyphicon glyphicon-step-backward
glyphicon glyphicon-fast-backward
glyphicon glyphicon-backward
glyphicon glyphicon-play
glyphicon glyphicon-pause
glyphicon glyphicon-stop
glyphicon glyphicon-forward
glyphicon glyphicon-fast-forward
glyphicon glyphicon-step-forward
glyphicon glyphicon-eject
glyphicon glyphicon-chevron-left
glyphicon glyphicon-chevron-right
glyphicon glyphicon-plus-sign
glyphicon glyphicon-minus-sign
glyphicon glyphicon-remove-sign
glyphicon glyphicon-ok-sign
glyphicon glyphicon-question-sign
glyphicon glyphicon-info-sign
glyphicon glyphicon-screenshot
glyphicon glyphicon-remove-circle
glyphicon glyphicon-ok-circle
glyphicon glyphicon-ban-circle
glyphicon glyphicon-arrow-left
glyphicon glyphicon-arrow-right
glyphicon glyphicon-arrow-up
glyphicon glyphicon-arrow-down
glyphicon glyphicon-share-alt
glyphicon glyphicon-resize-full
glyphicon glyphicon-resize-small
glyphicon glyphicon-exclamation-sign
glyphicon glyphicon-gift
glyphicon glyphicon-leaf
glyphicon glyphicon-fire
glyphicon glyphicon-eye-open
glyphicon glyphicon-eye-close
glyphicon glyphicon-warning-sign
glyphicon glyphicon-plane
glyphicon glyphicon-calendar
glyphicon glyphicon-random
glyphicon glyphicon-comment
glyphicon glyphicon-magnet
glyphicon glyphicon-chevron-up
glyphicon glyphicon-chevron-down
glyphicon glyphicon-retweet
glyphicon glyphicon-shopping-cart
glyphicon glyphicon-folder-close
glyphicon glyphicon-folder-open
glyphicon glyphicon-resize-vertical
glyphicon glyphicon-resize-horizontal
glyphicon glyphicon-hdd
glyphicon glyphicon-bullhorn
glyphicon glyphicon-bell
glyphicon glyphicon-certificate
glyphicon glyphicon-thumbs-up
glyphicon glyphicon-thumbs-down
glyphicon glyphicon-hand-right
glyphicon glyphicon-hand-left
glyphicon glyphicon-hand-up
glyphicon glyphicon-hand-down
glyphicon glyphicon-circle-arrow-right
glyphicon glyphicon-circle-arrow-left
glyphicon glyphicon-circle-arrow-up
glyphicon glyphicon-circle-arrow-down
glyphicon glyphicon-globe
glyphicon glyphicon-wrench
glyphicon glyphicon-tasks
glyphicon glyphicon-filter
glyphicon glyphicon-briefcase
glyphicon glyphicon-fullscreen
glyphicon glyphicon-dashboard
glyphicon glyphicon-paperclip
glyphicon glyphicon-heart-empty
glyphicon glyphicon-link
glyphicon glyphicon-phone
glyphicon glyphicon-pushpin
glyphicon glyphicon-usd
glyphicon glyphicon-gbp
glyphicon glyphicon-sort
glyphicon glyphicon-sort-by-alphabet
glyphicon glyphicon-sort-by-alphabet-alt
glyphicon glyphicon-sort-by-order
glyphicon glyphicon-sort-by-order-alt
glyphicon glyphicon-sort-by-attributes
glyphicon glyphicon-sort-by-attributes-alt
glyphicon glyphicon-unchecked
glyphicon glyphicon-expand
glyphicon glyphicon-collapse-down
glyphicon glyphicon-collapse-up
glyphicon glyphicon-log-in
glyphicon glyphicon-flash
glyphicon glyphicon-log-out
glyphicon glyphicon-new-window
glyphicon glyphicon-record
glyphicon glyphicon-save
glyphicon glyphicon-open
glyphicon glyphicon-saved
glyphicon glyphicon-import
glyphicon glyphicon-export
glyphicon glyphicon-send
glyphicon glyphicon-floppy-disk
glyphicon glyphicon-floppy-saved
glyphicon glyphicon-floppy-remove
glyphicon glyphicon-floppy-save
glyphicon glyphicon-floppy-open
glyphicon glyphicon-credit-card
glyphicon glyphicon-transfer
glyphicon glyphicon-cutlery
glyphicon glyphicon-header
glyphicon glyphicon-compressed
glyphicon glyphicon-earphone
glyphicon glyphicon-phone-alt
glyphicon glyphicon-tower
glyphicon glyphicon-stats
glyphicon glyphicon-sd-video
glyphicon glyphicon-hd-video
glyphicon glyphicon-subtitles
glyphicon glyphicon-sound-stereo
glyphicon glyphicon-sound-dolby
glyphicon glyphicon-sound-5-1
glyphicon glyphicon-sound-6-1
glyphicon glyphicon-sound-7-1
glyphicon glyphicon-copyright-mark
glyphicon glyphicon-registration-mark
glyphicon glyphicon-cloud-download
glyphicon glyphicon-cloud-upload
glyphicon glyphicon-tree-conifer
glyphicon glyphicon-tree-deciduous
glyphicon glyphicon-cd
glyphicon glyphicon-save-file
glyphicon glyphicon-open-file
glyphicon glyphicon-level-up
glyphicon glyphicon-copy
glyphicon glyphicon-paste
glyphicon glyphicon-alert
glyphicon glyphicon-equalizer
glyphicon glyphicon-king
glyphicon glyphicon-queen
glyphicon glyphicon-pawn
glyphicon glyphicon-bishop
glyphicon glyphicon-knight
glyphicon glyphicon-baby-formula
glyphicon glyphicon-tent
glyphicon glyphicon-blackboard
glyphicon glyphicon-bed
glyphicon glyphicon-apple
glyphicon glyphicon-erase
glyphicon glyphicon-hourglass
glyphicon glyphicon-lamp
glyphicon glyphicon-duplicate
glyphicon glyphicon-piggy-bank
glyphicon glyphicon-scissors
glyphicon glyphicon-bitcoin
glyphicon glyphicon-btc
glyphicon glyphicon-xbt
glyphicon glyphicon-yen
glyphicon glyphicon-jpy
glyphicon glyphicon-ruble
glyphicon glyphicon-rub
glyphicon glyphicon-scale
glyphicon glyphicon-ice-lolly
glyphicon glyphicon-ice-lolly-tasted
glyphicon glyphicon-education
glyphicon glyphicon-option-horizontal
glyphicon glyphicon-option-vertical
glyphicon glyphicon-menu-hamburger
glyphicon glyphicon-modal-window
glyphicon glyphicon-oil
glyphicon glyphicon-grain
glyphicon glyphicon-sunglasses
glyphicon glyphicon-text-size
glyphicon glyphicon-text-color
glyphicon glyphicon-text-background
glyphicon glyphicon-object-align-top
glyphicon glyphicon-object-align-bottom
glyphicon glyphicon-object-align-horizontal
glyphicon glyphicon-object-align-left
glyphicon glyphicon-object-align-vertical
glyphicon glyphicon-object-align-right
glyphicon glyphicon-triangle-right
glyphicon glyphicon-triangle-left
glyphicon glyphicon-triangle-bottom
glyphicon glyphicon-triangle-top
glyphicon glyphicon-console
glyphicon glyphicon-superscript
glyphicon glyphicon-subscript
glyphicon glyphicon-menu-left
glyphicon glyphicon-menu-right
glyphicon glyphicon-menu-down
glyphicon glyphicon-menu-up

How to use

For performance reasons, all icons require a base class and individual icon class. To use, place the following code just about anywhere. Be sure to leave a space between the icon and text for proper padding.

Don't mix with other components

Icon classes cannot be directly combined with other components. They should not be used along with other classes on the same element. Instead, add a nested <span> and apply the icon classes to the <span>.

Only for use on empty elements

Icon classes should only be used on elements that contain no text content and have no child elements.

Changing the icon font location

Bootstrap assumes icon font files will be located in the ../fonts/ directory, relative to the compiled CSS files. Moving or renaming those font files means updating the CSS in one of three ways:

Change the @icon-font-path and/or @icon-font-name variables in the source Less files.
Utilize the relative URLs option provided by the Less compiler.
Change the url() paths in the compiled CSS.

Use whatever option best suits your specific development setup.

Accessible icons

Modern versions of assistive technologies will announce CSS generated content, as well as specific Unicode characters. To avoid unintended and confusing output in screen readers (particularly when icons are used purely for decoration), we hide them with the aria-hidden="true" attribute.

If you're using an icon to convey meaning (rather than only as a decorative element), ensure that this meaning is also conveyed to assistive technologies – for instance, include additional content, visually hidden with the .sr-only class.

If you're creating controls with no other text (such as a <button> that only contains an icon), you should always provide alternative content to identify the purpose of the control, so that it will make sense to users of assistive technologies. In this case, you could add an aria-label attribute on the control itself.

<span class="glyphicon glyphicon-search" aria-hidden="true"></span>

Examples

Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.

<button type="button" class="btn btn-default" aria-label="Left Align">
  <span class="glyphicon glyphicon-align-left" aria-hidden="true"></span>
</button>

<button type="button" class="btn btn-default btn-lg">
  <span class="glyphicon glyphicon-star" aria-hidden="true"></span> Star
</button>

An icon used in an alert to convey that it's an error message, with additional .sr-only text to convey this hint to users of assistive technologies.

Enter a valid email address

<div class="alert alert-danger" role="alert">
  <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
  <span class="sr-only">Error:</span>
  Enter a valid email address
</div>

Extend form controls by adding text or buttons before, after, or on both sides of any text-based <input>. Use .input-group with an .input-group-addon to prepend or append elements to a single .form-control.

Textual `<input>`s only

Avoid using <select> elements here as they cannot be fully styled in WebKit browsers.

Avoid using <textarea> elements here as their rows attribute will not be respected in some cases.

Tooltips & popovers in input groups require special setting

When using tooltips or popovers on elements within an .input-group, you'll have to specify the option container: 'body' to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).

Don't mix with other components

Do not mix form groups or grid column classes directly with input groups. Instead, nest the input group inside of the form group or grid-related element.

Always add labels

Screen readers will have trouble with your forms if you don't include a label for every input. For these input groups, ensure that any additional label or functionality is conveyed to assistive technologies.

The exact technique to be used (<label> elements hidden using the .sr-only class, or use of the aria-label, aria-labelledby, aria-describedby, title or placeholder attribute) and what additional information will need to be conveyed will vary depending on the exact type of interface widget you're implementing. The examples in this section provide a few suggested, case-specific approaches.

Basic example

Place one add-on or button on either side of an input. You may also place one on both sides of an input.

We do not support multiple add-ons on a single side.

We do not support multiple form-controls in a single input group.

<div class="input-group">
  <span class="input-group-addon">
      <i class="icon icon-search"></i>
  </span>
  <input type="text" class="form-control" aria-label="Search" placeholder="Search...">
  <span class="input-group-addon">
      <a href=""><i class="icon icon-close"></i></a>
  </span>
</div>

<div class="input-group">
  <span class="input-group-addon">$</span>
  <input type="text" class="form-control text-xs-right p-r-0" aria-label="Amount (to the nearest dollar)">
  <span class="input-group-addon p-l-0">.00</span>
</div>

<div class="input-group">
  <span class="input-group-addon">
      <i class="icon icon-profile"></i>
  </span>
  <input type="password" class="form-control" aria-label="Enter password" placeholder="Enter password...">
  <span class="input-group-addon">
    <a href="">show</a> / <a href="">hide</a>
    &nbsp;
    <a href=""><i class="icon icon-close"></i></a>
  </span>
</div>

<div class="input-group">
  <span class="input-group-addon p-r-0">https://</span>
  <input type="text" class="form-control" aria-label="Your website" placeholder="www.example.com">
  <span class="input-group-addon">
    <i class="icon icon-globe"></i>
  </span>
</div>

Sizing

Add the relative form sizing classes to the .input-group itself and contents within will automatically resize—no need for repeating the form control size classes on each element.

<div class="input-group input-group-lg">
  <span class="input-group-addon" id="sizing-addon1">@</span>
  <input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon1">
</div>

<div class="input-group">
  <span class="input-group-addon" id="sizing-addon2">@</span>
  <input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon2">
</div>

<div class="input-group input-group-sm">
  <span class="input-group-addon" id="sizing-addon3">@</span>
  <input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon3">
</div>

Checkboxes and radio addons

Place any checkbox or radio option within an input group's addon instead of text.

<div class="row">
  <div class="col-lg-6">
    <div class="input-group">
      <span class="input-group-addon">
        <input type="checkbox" aria-label="...">
      </span>
      <input type="text" class="form-control" aria-label="...">
    </div><!-- /input-group -->
  </div><!-- /.col-lg-6 -->
  <div class="col-lg-6">
    <div class="input-group">
      <span class="input-group-addon">
        <input type="radio" aria-label="...">
      </span>
      <input type="text" class="form-control" aria-label="...">
    </div><!-- /input-group -->
  </div><!-- /.col-lg-6 -->
</div><!-- /.row -->

Button addons

Buttons in input groups are a bit different and require one extra level of nesting. Instead of .input-group-addon, you'll need to use .input-group-btn to wrap the buttons. This is required due to default browser styles that cannot be overridden.

<div class="row">
  <div class="col-lg-6">
    <div class="input-group">
      <span class="input-group-btn">
        <button class="btn btn-addon" type="button">Go!</button>
      </span>
      <input type="text" class="form-control" placeholder="Search for...">
    </div><!-- /input-group -->
  </div><!-- /.col-lg-6 -->
  <div class="col-lg-6">
    <div class="input-group input-group-sm">
      <input type="text" class="form-control" placeholder="Search for...">
      <span class="input-group-btn">
        <button class="btn btn-addon btn-sm" type="button">Go!</button>
      </span>
    </div><!-- /input-group -->
  </div><!-- /.col-lg-6 -->
</div><!-- /.row -->

Buttons with dropdowns

<div class="row">
  <div class="col-lg-6">
    <div class="input-group">
      <div class="input-group-btn">
        <button type="button" class="btn btn-addon dropdown-toggle" data-toggle="dropdown" aria-expanded="false">Action <span class="caret"></span></button>
        <ul class="dropdown-menu" role="menu">
          <li><a href="#">Action</a></li>
          <li><a href="#">Another action</a></li>
          <li><a href="#">Something else here</a></li>
          <li class="divider"></li>
          <li><a href="#">Separated link</a></li>
        </ul>
      </div><!-- /btn-group -->
      <input type="text" class="form-control" aria-label="...">
    </div><!-- /input-group -->
  </div><!-- /.col-lg-6 -->
  <div class="col-lg-6">
    <div class="input-group input-group-lg">
      <input type="text" class="form-control" aria-label="...">
      <div class="input-group-btn">
        <button type="button" class="btn btn-addon dropdown-toggle" data-toggle="dropdown" aria-expanded="false">Action <span class="caret"></span></button>
        <ul class="dropdown-menu dropdown-menu-right" role="menu">
          <li><a href="#">Action</a></li>
          <li><a href="#">Another action</a></li>
          <li><a href="#">Something else here</a></li>
          <li class="divider"></li>
          <li><a href="#">Separated link</a></li>
        </ul>
      </div><!-- /btn-group -->
    </div><!-- /input-group -->
  </div><!-- /.col-lg-6 -->
</div><!-- /.row -->

A lightweight, flexible component that can optionally extend the entire viewport to showcase key content on your site.

Hello, world!

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

Learn more

<div class="jumbotron">
  <h1>Hello, world!</h1>
  <p>...</p>
  <p><a class="btn btn-primary btn-lg" href="#" role="button">Learn more</a></p>
</div>

To make the jumbotron full width, and without rounded corners, place it outside all .containers and instead add a .container within.

<div class="jumbotron">
  <div class="container">
    ...
  </div>
</div>

Jumbotron with background image

To provide a background image for a jumbotron unit, wrap the unit with jumbotron-image, you will need to specify an background image with CSS

Hello, world!

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

Learn more

<div class="jumbotron-image" style="background-image: url('/assets/img/css2-bg.jpg')">
  <div class="jumbotron">
    ...
  </div>
</div>

Example

Example heading New

<h3>Example heading <span class="label label-default">New</span></h3>

Available variations

Add any of the below mentioned modifier classes to change the appearance of a label.

Default Primary Success Info Warning Danger

<span class="label label-default">Default</span>
<span class="label label-primary">Primary</span>
<span class="label label-success">Success</span>
<span class="label label-info">Info</span>
<span class="label label-warning">Warning</span>
<span class="label label-danger">Danger</span>

Have tons of labels?

Rendering problems can arise when you have dozens of inline labels within a narrow container, each containing its own inline-block element (like an icon). The way around this is setting display: inline-block;. For context and an example, see #13219.

List groups are a flexible and powerful component for displaying not only simple lists of elements, but complex ones with custom content.

Basic example

The most basic list group is simply an unordered list with list items, and the proper classes. Build upon it with the options that follow, or your own CSS as needed.

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

<ul class="list-group">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
  <li class="list-group-item">Porta ac consectetur ac</li>
  <li class="list-group-item">Vestibulum at eros</li>
</ul>

Badges

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

14 Cras justo odio
2 Dapibus ac facilisis in
1 Morbi leo risus

<ul class="list-group">
  <li class="list-group-item">
    <span class="badge">14</span>
    Cras justo odio
  </li>
</ul>

Linked items

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

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

<div class="list-group">
  <a href="#" class="list-group-item active">
    Cras justo odio
  </a>
  <a href="#" class="list-group-item">Dapibus ac facilisis in</a>
  <a href="#" class="list-group-item">Morbi leo risus</a>
  <a href="#" class="list-group-item">Porta ac consectetur ac</a>
  <a href="#" class="list-group-item">Vestibulum at eros</a>
</div>

Disabled items

Add .disabled to a .list-group-item to gray it out to appear disabled.

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

<div class="list-group">
  <a href="#" class="list-group-item disabled">
    Cras justo odio
  </a>
  <a href="#" class="list-group-item">Dapibus ac facilisis in</a>
  <a href="#" class="list-group-item">Morbi leo risus</a>
  <a href="#" class="list-group-item">Porta ac consectetur ac</a>
  <a href="#" class="list-group-item">Vestibulum at eros</a>
</div>

Contextual classes

Use contextual classes to style list items, default or linked. Also includes .active state.

Dapibus ac facilisis in
Dapibus ac facilisis in
Cras sit amet nibh libero
Dapibus ac facilisis in
Porta ac consectetur ac
Dapibus ac facilisis in
Vestibulum at eros
Dapibus ac facilisis in

Dapibus ac facilisis in Cras sit amet nibh libero Porta ac consectetur ac Vestibulum at eros

<ul class="list-group">
  <li class="list-group-item list-group-item-success">
    <div class="list-group-item-heading">Dapibus ac facilisis in</div>
    <span class="list-group-item-text">Dapibus ac facilisis in</span>
  </li>
  <li class="list-group-item list-group-item-info">
    <div class="list-group-item-heading">Cras sit amet nibh libero</div>
    <span class="list-group-item-text">Dapibus ac facilisis in</span>
  </li>
  <li class="list-group-item list-group-item-warning">
    <div class="list-group-item-heading">Porta ac consectetur ac</div>
    <span class="list-group-item-text">Dapibus ac facilisis in</span>
  </li>
  <li class="list-group-item list-group-item-danger">
    <div class="list-group-item-heading">Vestibulum at eros</div>
    <span class="list-group-item-text">Dapibus ac facilisis in</span>
  </li>
</ul>
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-success">Dapibus ac facilisis in</a>
  <a href="#" class="list-group-item list-group-item-info">Cras sit amet nibh libero</a>
  <a href="#" class="list-group-item list-group-item-warning">Porta ac consectetur ac</a>
  <a href="#" class="list-group-item list-group-item-danger">Vestibulum at eros</a>
</div>

Custom content

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

List group item heading

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.

List group item heading

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.

List group item heading

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.

<div class="list-group">
  <a href="#" class="list-group-item active">
    <h4 class="list-group-item-heading">List group item heading</h4>
    <p class="list-group-item-text">...</p>
  </a>
</div>

Indicate a page is loading, use only for large page sections. Never use more than one loader simultaneously.

<div class="loader">
  <div class="loader-spinner">
  </div>
  <div class="loader-flag">
    <svg xmlns="http://www.w3.org/2000/svg" width="52" height="52" viewBox="-2 -2 56 56">
      <polygon class="loader-flag-stroke"  stroke="#00B9FF" stroke-width="2" stroke-linejoin="miter" stroke-linecap="round" stroke-miterlimit="10" stroke-dasharray="300" stroke-dashoffset="300" fill="none" points="24.6,27.3 0,27.3 14.3,13.7 6.1,0 48.2,0 26.3,52 19.5,52 39.2,5.5 16.8,5.5 21.6,13.6 13.4,21.8 27,21.8" />
    </svg>
    <svg class="loader-flag-fill" xmlns="http://www.w3.org/2000/svg" width="52" height="52" viewBox="0 2 52 48">
      <polygon fill="#00B9FF" points="6.1,0 14.3,13.7 0,27.3 24.6,27.3 27,21.8 13.4,21.8 21.6,13.6 16.8,5.5 39.2,5.5 19.5,52 26.3,52 48.2,0 "/>
    </svg>
  </div>
</div>

Logos do not have a fixed size, they expand to fill the dimensions of their container. Make sure to specify a height otherwise your logo may not render.

<div class="logo logo-primary" style="height: 50px;"></div>

<div class="bg-primary">
    <div class="logo logo-inverse" style="height: 50px;"></div>
</div>

Logo sizes

Quick sizes that whose height is a multiple of our spacing.

<div class="logo logo-primary logo-3"></div>
<div class="logo logo-primary logo-4"></div>
<div class="logo logo-primary logo-5"></div>

Flags

<div class="flag flag-default" style="height: 50px;"></div>
<div class="flag flag-info" style="height: 50px;"></div>

Abstract object styles for building various types of components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.

Default media

The default media displays a media object (images, video, audio) to the left or right of a content block.

By convention our media objects use the .circle class.

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

AA

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Nested media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

<div class="media">
  <div class="media-left">
    <a class="circle" href="#">
      <img class="media-object" src="..." alt="...">
    </a>
  </div>
  <div class="media-body">
    <h5 class="media-heading">Media heading</h5>
    ...
  </div>
</div>

The classes .pull-left and .pull-right also exist and were previously used as part of the media component, but are deprecated for that use as of v3.3.0. They are approximately equivalent to .media-left and .media-right, except that .media-right should be placed after the .media-body in the html.

Media alignment

The images or other media can be aligned top, middle, or bottom. The default is top aligned.

Top aligned media

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

Middle aligned media

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

Bottom aligned media

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

<div class="media">
  <div class="media-left media-middle">
    <a class="circle" href="#">
      <img class="media-object" src="..." alt="...">
    </a>
  </div>
  <div class="media-body">
    <h5 class="media-heading">Middle aligned media</h5>
    ...
  </div>
</div>

Media list

With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

Nested media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

Nested media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

Nested media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

<ul class="media-list">
  <li class="media">
    <div class="media-left">
      <a class="circle"  href="#">
        <img class="media-object" src="..." alt="...">
      </a>
    </div>
    <div class="media-body">
      <h4 class="media-heading">Media heading</h4>
      ...
    </div>
  </li>
</ul>

Navbars are responsive meta components that serve as navigation headers for your application or site. They begin collapsed (and are toggleable) in mobile views and become horizontal as the available viewport width increases.

Justified navbar nav links are currently not supported.

Overflowing content

Since Bootstrap doesn't know how much space the content in your navbar needs, you might run into issues with content wrapping into a second row. To resolve this, you can:

Reduce the amount or width of navbar items.
Hide certain navbar items at certain screen sizes using responsive utility classes.
Change the point at which your navbar switches between collapsed and horizontal mode. Customize the @grid-float-breakpoint variable or add your own media query.

<nav class="navbar navbar-default">
  <div class="container-fluid">
    <!-- Brand and toggle get grouped for better mobile display -->
    <div class="navbar-header">
      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false">
        <span class="sr-only">Toggle navigation</span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
      </button>
      <a class="navbar-brand" href="#">Brand</a>
    </div>

    <!-- Collect the nav links, forms, and other content for toggling -->
    <div class="collapse navbar-collapse navbar-collapse-with-panel" id="bs-example-navbar-collapse-1">
      <a class="cover collapsed"
          data-toggle="collapse"
          data-target="#bs-example-navbar-collapse-1"
          aria-controls="bs-example-navbar-collapse-1"
          aria-expanded="false">
      <div class="navbar-collapse-panel">
        <ul class="nav navbar-nav">
          <li class="active"><a href="#">Link <span class="sr-only">(current)</span></a></li>
          <li><a href="#">Link</a></li>
          <li class="dropdown">
            <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Dropdown <span class="caret"></span></a>
            <ul class="dropdown-menu" role="menu">
              <li><a href="#">Action</a></li>
              <li><a href="#">Another action</a></li>
              <li><a href="#">Something else here</a></li>
              <li class="divider"></li>
              <li><a href="#">Separated link</a></li>
              <li class="divider"></li>
              <li><a href="#">One more separated link</a></li>
            </ul>
          </li>
        </ul>
        <form class="navbar-form navbar-left" role="search">
          <div class="form-group">
            <input type="text" class="form-control" placeholder="Search">
          </div>
          <button type="submit" class="btn btn-primary">Submit</button>
        </form>
        <ul class="nav navbar-nav navbar-right">
          <li><a href="#">Link</a></li>
          <li class="dropdown">
            <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Dropdown <span class="caret"></span></a>
            <ul class="dropdown-menu" role="menu">
              <li><a href="#">Action</a></li>
              <li><a href="#">Another action</a></li>
              <li><a href="#">Something else here</a></li>
              <li class="divider"></li>
              <li><a href="#">Separated link</a></li>
            </ul>
          </li>
        </ul>
      </div><!-- /.navbar-collapse-panel -->
      <a href="#" role="button"
          class="navbar-toggle close collapsed"
          data-toggle="collapse"
          data-target="#bs-example-navbar-collapse-1"
          aria-controls="bs-example-navbar-collapse-1"
          aria-expanded="false">&times;</a>
    </div><!-- /.navbar-collapse -->
  </div><!-- /.container-fluid -->
</nav>

Replace the navbar brand with your own image by swapping the text for an <img>. Since the .navbar-brand has its own padding and height, you may need to override some CSS depending on your image.

<nav class="navbar navbar-default">
  <div class="container-fluid">
    <div class="navbar-header">
      <a class="navbar-brand" href="#">
        <img alt="Brand" src="...">
      </a>
    </div>
  </div>
</nav>

Place form content within .navbar-form for proper vertical alignment and collapsed behavior in narrow viewports. Use the alignment options to decide where it resides within the navbar content.

As a heads up, .navbar-form shares much of its code with .form-inline via mixin. Some form controls, like input groups, may require fixed widths to be show up properly within a navbar.

<form class="navbar-form navbar-left" role="search">
  <div class="form-group">
    <input type="text" class="form-control" placeholder="Search">
  </div>
  <button type="submit" class="btn btn-primary">Submit</button>
</form>

Always add labels

Screen readers will have trouble with your forms if you don't include a label for every input. For these inline forms, you can hide the labels using the .sr-only class. There are further alternative methods of providing a label for assistive technologies, such as the aria-label, aria-labelledby or title attribute. If none of these is present, screen readers may resort to using the placeholder attribute, if present, but note that use of placeholder as a replacement for other labelling methods is not advised.

Add the .navbar-btn class to <button> elements not residing in a <form> to vertically center them in the navbar.

<button type="button" class="btn btn-primary navbar-btn">Sign in</button>

Add a text title with the .navbar-title class, normally on a heading class appropriate.

<h1 class="navbar-title">Title</h1>

Wrap strings of text in an element with .navbar-text, usually on a <p> tag for proper leading and color.

<p class="navbar-text">Signed in as Mark Otto</p>

For folks using standard links that are not within the regular navbar navigation component, use the .navbar-link class to add the proper colors for the default and inverse navbar options.

<p class="navbar-text navbar-right">Signed in as <a href="#" class="navbar-link">Mark Otto</a></p>

Align nav links, forms, buttons, or text, using the .navbar-left or .navbar-right utility classes. Both classes will add a CSS float in the specified direction. For example, to align nav links, put them in a separate <ul> with the respective utility class applied.

These classes are mixin-ed versions of .pull-left and .pull-right, but they're scoped to media queries for easier handling of navbar components across device sizes.

Add .navbar-fixed-top and include a .container or .container-fluid to center and pad navbar content.

<nav class="navbar navbar-default navbar-fixed-top">
  <div class="container">
    ...
  </div>
</nav>

Body padding required

The fixed navbar will overlay your other content, unless you add padding to the top of the <body>. Try out your own values or use our snippet below. Tip: By default, the navbar is 56px high.

body { padding-top: 56px; }

Make sure to include this after the core Bootstrap CSS.

Add .navbar-fixed-bottom and include a .container or .container-fluid to center and pad navbar content.

<nav class="navbar navbar-default navbar-fixed-bottom">
  <div class="container">
    ...
  </div>
</nav>

Body padding required

The fixed navbar will overlay your other content, unless you add padding to the bottom of the <body>. Try out your own values or use our snippet below. Tip: By default, the navbar is 56px high.

body { padding-bottom: 56px; }

Make sure to include this after the core Bootstrap CSS.

Create a full-width navbar that scrolls away with the page by adding .navbar-static-top and include a .container or .container-fluid to center and pad navbar content.

Unlike the .navbar-fixed-* classes, you do not need to change any padding on the body.

<nav class="navbar navbar-default navbar-static-top">
  <div class="container">
    ...
  </div>
</nav>

Modify the look of the navbar by adding .navbar-inverse.

Use the inverse nabar over background imagery and using helper classes like .bg-primary.

<nav class="navbar navbar-inverse">
  ...
</nav>

Use dropdowns in the navbar to have a nested navigation. The navbar dropdown have a top arrow and it's located just under its relative .dropdown-toggle element. It is visible on :hover and :focus-within states, enabling a convenient navigation with tabulation.

The .dropdown-toggle element could be an anchor a href="#"" or a button. It's recommended to use the button option, for semantic purposes.

To flatten a dropdown on mobile add the .navbar-collapse-flatten class to the .dropdown.

Try the demo to view these options and the responsive version as well.

<nav class="navbar navbar-inverse">
...
    <ul class="nav navbar-nav">
        <li class="dropdown">
            <button class="dropdown-toggle">Dropdown button<span class="caret"></span></button>
            <ul class="dropdown-menu" role="menu">
                <li><a href="#">Action</a></li>
                ...
            </ul>
        </li>
        <li class="dropdown">
            <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Dropdown <span class="caret"></span></a>
            <ul class="dropdown-menu" role="menu">
                <li><a href="#">Action</a></li>
                ...
            </ul>
        </li>
    </ul>
    <ul class="nav navbar-nav navbar-right">
        <li><a href="#">Link</a></li>
        <li class="dropdown">
            <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Dropdown <span class="caret"></span></a>
            <ul class="dropdown-menu" role="menu">
                <li><a href="#">Action</a></li>
                ...
            </ul>
        </li>
    </ul>
</nav>

Secondary navigation for expecific navigation of the site. Used for Blog, products like Swift/bic, Currency Converter, etc.

Add .subnav to navbar or header, and .subnav-menu to navbar-nav to get the secondary navigation.

Add .navbar-title-link to the secondary navigation title link. Must have the .active state on home.

On mobile, the subnav-menu behaves like an ordinary navbar-nav.

Try the demo to view these options and the responsive version as well.

How subnav works

Same markup. Add two classes to convert a conventional navbar into a secondary navigation option.

<nav class="navbar subnav">
  ...
  <ul class="nav navbar-nav subnav-menu">
    <li class="active">
      <a class="navbar-title-link" href="/"> Title </a>
    </li>
    <li class="dropdown">
    ...
    </li>
    ...
  </ul>
  ...
</nav>

<nav class="navbar subnav navbar-inverse bg-primary">
  ...
  <ul class="nav navbar-nav subnav-menu">
    <li>
      <a class="navbar-title-link" href="/"> Title </a>
    </li>
    <li class="dropdown">
    ...
    </li>
    ...
  </ul>
  ...
</nav>

Navs available in Bootstrap have shared markup, starting with the base .nav class, as well as shared states. Swap modifier classes to switch between each style.

Using navs for tab panels requires JavaScript tabs plugin

For tabs with tabbable areas, you must use the tabs JavaScript plugin. The markup will also require additional role and ARIA attributes – see the plugin's example markup for further details.

Make navs used as navigation accessible

If you are using navs to provide a navigation bar, be sure to add a role="navigation" to the most logical parent container of the <ul>, or wrap a <nav> element around the whole navigation. Do not add the role to the <ul> itself, as this would prevent it from being announced as an actual list by assistive technologies.

Tabs

Note the .nav-tabs class requires the .nav base class.

<ul class="nav nav-tabs">
  <li role="presentation" class="active"><a href="#">Home</a></li>
  <li role="presentation"><a href="#">Profile</a></li>
  <li role="presentation"><a href="#">Messages</a></li>
</ul>

Stacked Nav

Navs are also vertically stackable. Just add .nav-stacked.

<ul class="nav nav-stacked">
  ...
</ul>

Justified

Easily make tabs or pills equal widths of their parent at screens wider than 768px with .nav-justified. On smaller screens, the nav links are stacked.

Justified navbar nav links are currently not supported.

Safari and responsive justified navs

As of v8.0, Safari exhibits a bug in which resizing your browser horizontally causes rendering errors in the justified nav that are cleared upon refreshing. This bug is also shown in the justified nav example.

<ul class="nav nav-tabs nav-justified">
  ...
</ul>
<ul class="nav nav-pills nav-justified">
  ...
</ul>

Disabled links

For any nav component (tabs or pills), add .disabled for gray links and no hover effects.

Link functionality not impacted

This class will only change the <a>'s appearance, not its functionality. Use custom JavaScript to disable links here.

<ul class="nav nav-tabs">
  ...
  <li role="presentation" class="disabled"><a href="#">Disabled link</a></li>
  ...
</ul>

Using dropdowns

Add dropdown menus with a little extra HTML and the dropdowns JavaScript plugin.

Tabs with dropdowns

<ul class="nav nav-tabs">
  ...
  <li role="presentation" class="dropdown">
    <a class="dropdown-toggle" data-toggle="dropdown" href="#" role="button" aria-expanded="false">
      Dropdown <span class="caret"></span>
    </a>
    <ul class="dropdown-menu" role="menu">
      ...
    </ul>
  </li>
  ...
</ul>

A inline heading with an underline for separating parts of a page. It can utilize any heading, as well as most other components (with additional styles).

<h5 class="page-header">Example page header </h5>

Pagination

Provide pagination links for your site or app with the multi-page pagination component.

Default pagination

Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.

<nav>
  <ul class="pagination">
    <li><a href="#">1</a></li>
    <li><a href="#">2</a></li>
    <li><a href="#">3</a></li>
    <li><a href="#">4</a></li>
    <li><a href="#">5</a></li>
  </ul>
</nav>

Disabled and active states

Links are customizable for different circumstances. Use .disabled for unclickable links and .active to indicate the current page.

<nav>
  <ul class="pagination">
    <li class="active">
      <span>1 <span class="sr-only">(current)</span></span>
    </li>
    <li>
      <a href="">2 <span class="sr-only">(current)</span></a>
    </li>
    <li>
      <span>...</span>
    </li>
    <li class="active">
      <a href="">2 </a>
    </li>
  </ul>
</nav>

You can optionally swap out active or disabled anchors for <span>, or omit the anchor in the case of the previous/next arrows, to remove click functionality while retaining intended styles.

<nav>
  <ul class="pagination">
    <li class="active">
      <span>1 <span class="sr-only">(current)</span></span>
    </li>
    <li>
      <a href="">2</a>
    </li>
    <li>
      <span>...</span>
    </li>
    <li>
      <a href="">12</a>
    </li>
  </ul>
</nav>

Pagination text

Our pagination will normally be associated with .pagination-text to describe what is visualised and the total available.

Showing 1 – 10 of 120.

<div class="clearfix text-xs-center">
  <div class="pagination-text pull-md-left text-md-left">
    Showing <strong>1 &ndash; 10</strong> of <strong>120</strong>.
  </div>
  <nav class="pull-md-right text-md-right">
    <ul class="pagination">...</ul>
  </nav>
</div>

Inverse

On grey backgrounds we invert our hover states, add .pagination-inverse for additional styles.

Showing

of 120

<nav><ul class="pagination pagination-inverse">...</ul></nav>

While not always necessary, sometimes you need to put your DOM in a box. For those situations, try the panel component.

Basic example

By default, all the .panel does is apply some basic border and padding to contain some content.

Basic panel example

<div class="panel panel-default">
  <div class="panel-body">
    Basic panel example
  </div>
</div>

Panel with heading

Easily add a heading container to your panel with .panel-heading. You may also include any <h1>-<h6> with a .panel-title class to add a pre-styled heading.

For proper link coloring, be sure to place links in headings within .panel-title.

Panel heading without title

Panel content

Panel title

Panel content

<div class="panel panel-default">
  <div class="panel-heading">Panel heading without title</div>
  <div class="panel-body">
    Panel content
  </div>
</div>

<div class="panel panel-default">
  <div class="panel-heading">
    <h3 class="panel-title">Panel title</h3>
  </div>
  <div class="panel-body">
    Panel content
  </div>
</div>

Panel with footer

Wrap buttons or secondary text in .panel-footer. Note that panel footers do not inherit colors and borders when using contextual variations as they are not meant to be in the foreground.

Panel content

Panel footer

<div class="panel panel-default">
  <div class="panel-body">
    Panel content
  </div>
  <div class="panel-footer">Panel footer</div>
</div>

With tables

Add any non-bordered .table within a panel for a seamless design. If there is a .panel-body, we add an extra border to the top of the table for separation.

Panel heading

Some default panel content here. Nulla vitae elit libero, a pharetra augue. Aenean lacinia bibendum nulla sed consectetur. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Nullam id dolor id nibh ultricies vehicula ut id elit.

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
2	Jacob	Thornton	@fat
3	Larry	the Bird	@twitter

<div class="panel panel-default">
  <!-- Default panel contents -->
  <div class="panel-heading">
    <h3 class="panel-title">Panel heading</h3>
  </div>
  <div class="panel-body">
    <p>...</p>
  </div>

  <!-- Table -->
  <table class="table">
    ...
  </table>
</div>

If there is no panel body, the component moves from panel header to table without interruption.

Panel heading

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
2	Jacob	Thornton	@fat
3	Larry	the Bird	@twitter

<div class="panel panel-default">
  <!-- Default panel contents -->
  <div class="panel-heading">
    <h3 class="panel-title">Panel heading</h3>
  </div>

  <!-- Table -->
  <table class="table">
    ...
  </table>
</div>

With list groups

Easily include full-width list groups within any panel.

Panel heading

Some default panel content here. Nulla vitae elit libero, a pharetra augue. Aenean lacinia bibendum nulla sed consectetur. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Nullam id dolor id nibh ultricies vehicula ut id elit.

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

<div class="panel panel-default">
  <!-- Default panel contents -->
  <div class="panel-heading">
    <h3 class="panel-title">Panel heading</h3>
  </div>
  <div class="panel-body">
    <p>...</p>
  </div>

  <!-- List group -->
  <ul class="list-group">
    <li class="list-group-item">Cras justo odio</li>
    <li class="list-group-item">Dapibus ac facilisis in</li>
    <li class="list-group-item">Morbi leo risus</li>
    <li class="list-group-item">Porta ac consectetur ac</li>
    <li class="list-group-item">Vestibulum at eros</li>
  </ul>
</div>

Process is used for loading and processing states. It can be used as a simple loading indicator, for asynchronous tasks with positive or negative results, or simply for indicating a task has already completed with successful or unsuccessful result.

Please don't use the SVG markup directly

There is a component in the styleguide-components repository which implements the markup in a simple tw-process component.

<span class='process process-sm'>
  <span class='process-icon-container'>
    <span class='process-icon-horizontal'></span>
    <span class='process-icon-vertical'></span>
  </span>
  <svg version='1.1'
    xmlns='http://www.w3.org/2000/svg'
    xml:space='preserve'>
    <circle class='process-circle' cx='50%' cy='50%' r='45%'
      fill-opacity='0.0' />
  </svg>
</span>
<span class='process process-sm process-success'>
  ...
</span>
<span class='process process-sm process-danger'>
  ...
</span>

Process sizes

Our sized variants are designed to work alongside our circle components. Curenctly we have extras small (xs), small (sm), and extra large variants for different use cases.

Simply add the relevant modifier class .process-xs, .process-sm, or .process-xl.

<span class='process process-xs'>
  ...
</span>
<span class='process process-sm'>
  ...
</span>
<span class='process process-xl'>
  ...
</span>

Button process

Process can be used in buttons to convey ongoing actions as a result of click.

<button class='btn btn-block btn-primary'>
  <span class='process process-xs'>
    ...
  </span>
</button>
<button class='btn btn-block btn-default'>
  <span class='process process-xs'>
    ...
  </span>
</button>
<button class='btn btn-success'>
  <span class='process process-xs'>
    ...
  </span>
</button>

Process inverse

There is also an inverse variant for use on dark, or blue backgrounds, using the modifier .process-inverse.

<span class='process process-inverse process-sm'>
  ...
</span>

Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.

Cross-browser compatibility

Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in Internet Explorer 9 and below or older versions of Firefox. Opera 12 does not support animations.

Basic example

Default progress bar.

<div class="progress">
  <div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%;">
    <span class="sr-only">60% Complete</span>
  </div>
</div>

Large progress bars

The large progress bar can be used to visually depict a comparison.

<div class="progress progress-lg">
  <div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%;">
    <span class="sr-only">60% Complete</span>
  </div>
</div>

With label

Remove the <span> with .sr-only class from within the progress bar to show a visible percentage.

60%

<div class="progress progress-lg">
  <div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%;">
    60%
  </div>
</div>

To ensure that the label text remains legible even for low percentages, consider adding a min-width to the progress bar.

0%

2%

<div class="progress progress-lg">
  <div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
    0%
  </div>
</div>
<div class="progress progress-lg">
  <div class="progress-bar" role="progressbar" aria-valuenow="2" aria-valuemin="0" aria-valuemax="100" style="width: 2%;">
    2%
  </div>
</div>

Contextual alternatives

Progress bars use some of the same button and alert classes for consistent styles.

<div class="progress">
  <div class="progress-bar progress-bar-primary" role="progressbar" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100" style="width: 100%">
    <span class="sr-only">100% Complete (success)</span>
  </div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-success" role="progressbar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="width: 40%">
    <span class="sr-only">40% Complete (success)</span>
  </div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-info" role="progressbar" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
    <span class="sr-only">20% Complete</span>
  </div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-warning" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%">
    <span class="sr-only">60% Complete (warning)</span>
  </div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-danger" role="progressbar" aria-valuenow="80" aria-valuemin="0" aria-valuemax="100" style="width: 80%">
    <span class="sr-only">80% Complete (danger)</span>
  </div>
</div>

Allow browsers to determine video or slideshow dimensions based on the width of their containing block by creating an intrinsic ratio that will properly scale on any device.

Rules are directly applied to <iframe>, <embed>, <video>, and <object> elements; optionally use an explicit descendant class .embed-responsive-item when you want to match the styling for other attributes.

Pro-Tip! You don't need to include frameborder="0" in your <iframe>s as we override that for you.

<!-- 16:9 aspect ratio -->
<div class="embed-responsive embed-responsive-16by9">
  <iframe class="embed-responsive-item" src="..."></iframe>
</div>

<!-- 4:3 aspect ratio -->
<div class="embed-responsive embed-responsive-4by3">
  <iframe class="embed-responsive-item" src="..."></iframe>
</div>

Sequence is a flexible component for portraying a sequence of steps. It can be used to portray a sequence that the user may be required to complete, and the current progress through that sequence.

It can also be used to connect other elements, and to portray a set of transformations that relate them.

Sequence
Summary of something
Step two
Step three

Sequence
Summary of something
Step two
Step three

<ul class="sequence">
  <li>
    Step one
    <p class="small">Summary of something</p>
  </li>
  <li>Step two</li>
  <li class="active">Step three</li>
</ul>

<ul class="sequence">
  <li>
    <a href="">Step one</a>
    <p class="small">Summary of something</p>
  </li>
  <li><a href="">Step two</a></li>
  <li class="active"><a href="">Step three</a></li>
</ul>

Sequence progress

We can use the sequence component to convey progress using one of our contextual variants.

All steps up to and including the active step will be coloured. If no step is active the whole bar will be coloured.

Sequence primary
Summary of something
Step two
Step three

<ul class="sequence sequence-primary">...</ul>

Contextual alternatives

Sequence info
Summary of something
Step two
Step three

Sequence success
Summary of something
Step two
Step three

Sequence warning
Summary of something
Step two
Step three

Sequence danger
Summary of something
Step two
Step three

<ul class="sequence sequence-info">...</ul>
<ul class="sequence sequence-success">...</ul>
<ul class="sequence sequence-warning">...</ul>
<ul class="sequence sequence-danger">...</ul>

Sequence inverse

Inverse variant for use in combination with .bg-primary utility class.

Sequence info
Summary of something
Step two
Step three

Sequence success
Summary of something
Step two
Step three

<div class="bg-primary">
  <ul class="sequence sequence-inverse">...</ul>
  <ul class="sequence sequence-inverse sequence-info sequence-top sequence-bottom">...</ul>
</div>

Sequence connections

The connecting variants allow us to use sequence to convey a set of transformations that relate to other elements.

Lines up with checkbox

Sequence bottom
Summary of something
Step two
Step three

Sequence top/bottom
Summary of something
Step two
Step three

Sequence top
Summary of something
Step two
Step three

<ul class="sequence sequence-top">...</ul>
<ul class="sequence sequence-top sequence-bottom">...</ul>
<ul class="sequence sequence-bottom">...</ul>

Sequence icons

Sequence icons allow us to introduce iconography to help convey the meaning of a step in our sequence.

Sequence icon
Step two
Step three

Sequence icon
Step two
Step three

...
<li><span class="sequence-icon"><i class="icon icon-lock"></i></span></li>
<li>
  <a href="">
    <span class="sequence-icon"><i class="icon icon-fast-flag"></i></span>
  </a>
</li>
...

Sequence hollow

A variant with hollow pips on non-active steps.

Step one
Step two
Step three

Step one
Step two
Step three

<ul class="sequence sequence-hollow sequence-info">...</u>

Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.

If you're looking for Pinterest-like presentation of thumbnails of varying heights and/or widths, you'll need to use a third-party plugin such as Masonry, Isotope, or Salvattore.

Default example

By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.

<div class="row">
  <div class="col-xs-12 col-sm-6 col-md-3">
    <a href="#" class="thumbnail">
      <img src="..." alt="...">
    </a>
  </div>
  ...
</div>

Custom content

With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.

Use the .row-equal-height modifier to match the height of the thumbnails.

Thumbnail label

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

Button Button

Thumbnail label

Cras justo odio, dapibus ac facilisis in.

Button Button

Thumbnail label

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

Button Button

<div class="row row-equal-height">
  <div class="col-xs-12 col-sm-6 col-xl-4">
    <div class="thumbnail">
      <img src="..." alt="...">
      <div class="caption">
        <h4>Thumbnail label</h4>
        <p>...</p>
        <p><a href="#" class="btn btn-primary" role="button">Button</a> <a href="#" class="btn btn-default" role="button">Button</a></p>
      </div>
    </div>
  </div>
</div>

Provide a set of related clickable options that are easily glanceable and compareable.

Simple Tile

In it's simplest form, a tile shows a circle containing intials or an icon, alongside a title.

Tiles should have role="button" so that screen readers will recognise them as clickable, and tabindex="0" to provide focus support for keyboards.

AZ

Myself

<div class="tile" tabindex="0" role="button">
  <div class="circle circle-lg">AZ</div>
  <h5>...</h5>
</div>

Responsive Tiles

Better responsive behaviour can be achieved using the .tile-icon and .tile-text containers.

When using responsive tiles always use .circle-responsive to scale your icon on smaller screens.

AZ

Myself

Summary description

<div class="tile" tabindex="0" role="button">
  <div class="tile-icon">
      <div class="circle circle-lg circle-responsive">AZ</div>
  </div>
  <div class="tile-text">
    <h5>...</h5>
    <p>...</p>
  </div>
</div>

Tile rows

Normally tiles are used in rows, we use our grid columns to dictate how many tiles appear in each row at various screen sizes, our tiles should be of equal height so we use the row modifier .row-equal-height to make each tile in a row match.

Be concise when adding additional text. The user will use this information to compare between options.

Tile rows use flexbox for matched height, which may not work in earlier versions of Internet Explorer.

Someone else

EUR account ending 2843

Myself

EUR account ending 5234

Really long title that causes text wrap

EUR account ending 6798

<div class="row row-equal-height">
  <div class="col-xs-12 col-sm-6 col-md-4 m-b-0">
    <div class="tile" tabindex="0" role="button">
      ...
    </div>
  </div>
  <div class="col-xs-12 col-sm-6 col-md-4 m-b-0">
    <div class="tile" tabindex="0" role="button">
      ...
    </div>
  </div>
  <div class="col-xs-12 col-sm-6 col-md-4 m-b-0">
    <div class="tile" tabindex="0" role="button">
      ...
    </div>
  </div>
</div>

Tiles with unique information

When the option has further information unique to it alone and it is 100% necessary to show it, do so below a hr tag within a p

Credit Card

Visa and Mastercard are supported

+£1 card fee

Bank Transfer

Send the money from your Internet Banking

1 day slower

<div class="tile" tabindex="0" role="button">
  <div class="tile-icon">
    <div class="circle circle-lg circle-responsive">
      <i class="icon icon-card"></i>
    </div>
  </div>
  <div class="tile-text">
    <h5>...</h5>
    <p>...</p>
    <hr />
    <p>...</p>
  </div>
</div>

Benefits of a certain tile

Add a tile-ribbon-benefit div within the tile if benefits of that tile are worth showing to the user. Copy should be kept short as space is limited.

Faster

Debit Card

Visa and Mastercard are supported

<div class="tile" tabindex="0" role="button">
  <div class="tile-ribbon-benefit">...</div>
  <div class="tile-icon">
    <div class="circle circle-lg circle-responsive">
      ...
    </div>
  </div>
  <div class="tile-text">
    <h5>...</h5>
    <p>...</p>
  </div>
</div>

Disabled Tile

Add a tile-disabled class to tile when the option is disabled, providing an explanation to the user as to why they cannot select that option.

Credit Card

Visa and Mastercard are supported

Unavailable for amounts larger than £2000

<div class="tile tile-disabled">
  <div class="tile-icon">
    <div class="circle circle-lg circle-responsive">
      ...
    </div>
  </div>
  <div class="tile-text">
    <h5>...</h5>
    <p>...</p>
    <hr />
    <p>...</p>
  </div>
</div>

Inverse Tiles

On grey backgrounds use the .tile-inverse variant.

Earn £50 credit

Give someone a free transfer for up to £500

Click here to share

<div class="tile tile-inverse" tabindex="0" role="button">
  ...
</div>

Contextual Tile Variants

Add a contextual class convey state within the tile.

Earn £50 credit

Give someone a free transfer for up to £500

Click here to share

Request money

From friends and family and customers

Click here to request

Rate alerts

Sign up no to be alerted when the rate reaches your chosen value

Click here to sign up

Please verify

You will need to verify your identity when you have transferred over £10000.

Click here to verify now

<div class="tile tile-success" tabindex="0" role="button">
  ...
</div>
<div class="tile tile-warning" tabindex="0" role="button">
  ...
</div>
<div class="tile tile-danger" tabindex="0" role="button">
  ...
</div>
<div class="tile tile-info" tabindex="0" role="button">
  ...
</div>

Default well

Use the well as a simple effect on an element to make it a little informative card.

Look, I'm in a well!

<div class="well-xs">...</div>

Optional classes

Control on which breakpoints well styles are applied with some responsive classes. Works with "xs" "sm" "md" "lg" "xl"

Look, I'm only in a well when equal or larger than lg!

<div class="well-lg">...</div>

Look, I'm only in a well when equal or larger than sm!

<div class="well-sm">...</div>

Components

Alerts

Examples

No default class

Dismissible alerts

Requires JavaScript alert plugin

Ensure proper behavior across all devices

Connecting alerts

Links in alerts

Badges

Color

Navigation Icon

Self collapsing

Cross-browser compatibility

Adapts to active nav states

Breadcrumbs

Button dropdowns

Plugin dependency

Single button dropdowns

Input button dropdowns

Split button dropdowns

Sizing

Dropup variation

Button groups

Tooltips & popovers in button groups require special setting

Ensure correct role and provide a label

Basic example

Button toolbar

Button toolbar collapse

Sizing

Nesting

Vertical variation

Justified button groups

Handling borders

IE8 and borders

With <a> elements

Links acting as buttons

With <button> elements

Circles

Size variations

Inverse circles

Responsive circles

Circle backgrounds

Defaults

Default circle

Sizes

xs

sm

md

lg

xl

Positions (center)

Top

right

bottom

left

Position (center) x/y combinations

top left

Top Right

Bottom Left

Bottom Right

Position (box edge)

Top

Right

Bottom

Left

Position (box edge) x/y combinations

Top Left

Top Right

Bottom Left

Bottom Right

Size and positions

xs top right

sm bottom right

md bottom left

lg bottom left

xl left

Clipping boxes

Colours

Dropdowns

Ensure correct `role` and provide a label

With `<a>` elements

With `<button>` elements

Deprecated `.pull-right` alignment

Textual `<input>`s only