Toasts

Push notifications to your visitors with a toast, a lightweight and easily customizable alert message.

Examples

Basic

Hello, world! This is a toast message.

              
  <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
    <div class="toast-header">
      <img src="../../assets/images/logo-mark-sm.png" class="rounded me-2 img-fluid" alt="Logo">
      <strong class="me-auto">System</strong>
      <small class="text-muted">11 mins ago</small>
      <button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
    </div>
    <div class="toast-body">
      Hello, world! This is a toast message.
    </div>
  </div>

Live example

Hello, world! This is a toast message.

              
  <button type="button" class="btn btn-primary" id="liveToastBtn">Show live toast</button>

  <div class="position-fixed bottom-0 end-0 p-3" style="z-index: 11">
    <div id="liveToast" class="toast" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="toast-header">
        <img src="../../assets/images/logo-mark-sm.png" class="rounded me-2 img-fluid" alt="Logo">
        <strong class="me-auto">System</strong>
        <small>11 mins ago</small>
        <button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
      <div class="toast-body">
        Hello, world! This is a toast message.
      </div>
    </div>
  </div>

Stacking

You can stack toasts by wrapping them in a toast container, which will vertically add some spacing.

See? Just like this.

Heads up, toasts will stack automatically

              
  <div class="toast-container">
    <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="toast-header">
        <img src="../../assets/images/logo-mark-sm.png" class="rounded me-2 img-fluid" alt="Logo">
        <strong class="me-auto">System</strong>
        <small class="text-muted">just now</small>
        <button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
      <div class="toast-body">
        See? Just like this.
      </div>
    </div>
  
    <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="toast-header">
        <img src="../../assets/images/logo-mark-sm.png" class="rounded me-2 img-fluid" alt="Logo">
        <strong class="me-auto">System</strong>
        <small class="text-muted">2 seconds ago</small>
        <button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
      <div class="toast-body">
        Heads up, toasts will stack automatically
      </div>
    </div>
  </div>

Custom content

Customize your toasts by removing sub-components, tweaking them with utilities, or by adding your own markup. Here we’ve created a simpler toast by removing the default .toast-header, adding icon from Bootstrap Icons, and using some flexbox utilities to adjust the layout.

Hello, world! This is a toast message.

              
  <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
    <div class="d-flex">
      <div class="toast-body">
        <i class="bi bi-info-circle me-1"></i> Hello, world! This is a toast message.
      </div>
      <button type="button" class="btn-close me-2 m-auto" data-bs-dismiss="toast" aria-label="Close"></button>
    </div>
  </div>

Alternatively, you can also add additional controls and components to toasts.

Hello, world! This is a toast message.

              
  <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
    <div class="toast-body">
      Hello, world! This is a toast message.
      <div class="mt-2 pt-2">
        <button type="button" class="btn btn-primary btn-xs">Take action</button>
        <button type="button" class="btn btn-secondary btn-xs" data-bs-dismiss="toast">Close</button>
      </div>
    </div>
  </div>

Color schemes

Building on the above example, you can create different toast color schemes with our color and background utilities. Here we’ve added .bg-primary and .text-white to the .toast, and then added .btn-close-white to our close button. For a crisp edge, we remove the default border with .border-0.

Hello, world! This is a toast message.

Your setting has been updated.

Warning, you storage is almost full.

Server error: connection timed out!

              
  <div class="toast-container">
    <div class="toast text-white bg-primary border-0 fade show" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="d-flex">
        <div class="toast-body">
          <i class="bi bi-info-circle-fill me-1"></i> Hello, world! This is a toast message.
        </div>
        <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
    </div>

    <div class="toast text-white bg-success border-0 fade show" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="d-flex">
        <div class="toast-body">
          <i class="bi bi-check-circle-fill me-1"></i> Your setting has been updated.
        </div>
        <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
    </div>

    <div class="toast text-white bg-warning border-0 fade show" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="d-flex">
        <div class="toast-body">
          <i class="bi bi-exclamation-triangle-fill me-1"></i> Warning, you storage is almost full.
        </div>
        <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
    </div>

    <div class="toast text-white bg-danger border-0 fade show" role="alert" aria-live="assertive" aria-atomic="true">
      <div class="d-flex">
        <div class="toast-body">
          <i class="bi bi-dash-circle-fill me-1"></i> Server error: connection timed out!
        </div>
        <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast" aria-label="Close"></button>
      </div>
    </div>
  </div>

Placement

Place toasts with custom CSS as you need them. The top right is often used for notifications, as is the top middle. If you’re only ever going to show one toast at a time, put the positioning styles right on the .toast.

Hello, world! This is a toast message.

1m ago

              
  <form>
    <div class="mb-3">
      <label for="selectToastPlacement">Toast placement</label>
      <select class="form-select mt-2" id="selectToastPlacement">
        <option value="" selected="">Select a position...</option>
        <option value="top-0 start-0">Top left</option>
        <option value="top-0 start-50 translate-middle-x">Top center</option>
        <option value="top-0 end-0">Top right</option>
        <option value="top-50 start-0 translate-middle-y">Middle left</option>
        <option value="top-50 start-50 translate-middle">Middle center</option>
        <option value="top-50 end-0 translate-middle-y">Middle right</option>
        <option value="bottom-0 start-0">Bottom left</option>
        <option value="bottom-0 start-50 translate-middle-x">Bottom center</option>
        <option value="bottom-0 end-0">Bottom right</option>
      </select>
    </div>
  </form>

  <div aria-live="polite" aria-atomic="true" class="bg-dark position-relative docs-example-toasts">
    <div class="toast-container position-absolute p-3 top-0 start-0" id="toastPlacement" data-original-class="toast-container position-absolute p-3">
      <div class="toast fade show" id="toastItem" data-bs-autohide="false">
        <div class="d-flex align-items-start">
          <div class="toast-body">
            Hello, world! This is a toast message.
            <div>
              <small class="text-muted">1m ago</small>
            </div>
          </div>
          <button type="button" class="btn-close me-2 ms-auto mt-2" data-bs-dismiss="toast" aria-label="Close"></button>
        </div>
      </div>
    </div>
  </div>

Getting Started

Layout

Content

Components

Utility classes

Extend

Toasts

Examples

Basic

Live example

Stacking

Custom content

Color schemes

Placement

On this page