keyboard_double_arrow_left
help Help & getting started
  1. Home
  2. Dropdown

Dropdowns.

Toggle contextual overlays for displaying lists of links and more with the Bootstrap dropdown plugin. Click here

Single button

Any single .btn can be turned into a dropdown toggle with some markup changes. Here’s how you can put them to work with <button> elements:


<div class="btn-group">
  <button type="button" class="btn btn-danger dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
	Action
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Another action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Something else here</a></li>
	<li><hr class="dropdown-divider"></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Separated link</a></li>
  </ul>
</div>

<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
	Dropdown button
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Another action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Something else here</a></li>
  </ul>
</div>

Split button

Similarly, create split button dropdowns with virtually the same markup as single button dropdowns, but with the addition of .dropdown-toggle-split for proper spacing around the dropdown caret.


<div class="btn-group">
  <button type="button" class="btn btn-danger">Action</button>
  <button type="button" class="btn btn-danger dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
	<span class="visually-hidden">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Another action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Something else here</a></li>
	<li><hr class="dropdown-divider"></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Separated link</a></li>
  </ul>
</div>

Sizing

Button dropdowns work with buttons of all sizes, including default and split dropdown buttons.


<!-- Large button groups (default and split) -->
<div class="btn-group">
  <button class="btn btn-secondary btn-lg dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
    Large button
  </button>
  <ul class="dropdown-menu">
    ...
  </ul>
</div>
<div class="btn-group">
  <button class="btn btn-secondary btn-lg" type="button">
    Large split button
  </button>
  <button type="button" class="btn btn-lg btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
    <span class="visually-hidden">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu">
    ...
  </ul>
</div>

<div class="btn-group">
  <button class="btn btn-secondary btn-sm dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
    Small button
  </button>
  <ul class="dropdown-menu">
    ...
  </ul>
</div>
<div class="btn-group">
  <button class="btn btn-secondary btn-sm" type="button">
    Small split button
  </button>
  <button type="button" class="btn btn-sm btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
    <span class="visually-hidden">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu">
    ...
  </ul>
</div>

Dark dropdowns

Opt into darker dropdowns to match a dark navbar or custom style by adding .dropdown-menu-dark onto an existing .dropdown-menu. No changes are required to the dropdown items.


<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
	Dropdown button
  </button>
  <ul class="dropdown-menu dropdown-menu-dark">
	<li><a class="dropdown-item active" href="javascript:void(0);">Action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Another action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Something else here</a></li>
	<li><hr class="dropdown-divider"></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Separated link</a></li>
  </ul>
</div>

<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
  <div class="container-fluid">
	<a class="navbar-brand" href="javascript:void(0);">Navbar</a>
	<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDarkDropdown" aria-controls="navbarNavDarkDropdown" aria-expanded="false" aria-label="Toggle navigation">
	  <span class="navbar-toggler-icon"></span>
	</button>
	<div class="collapse navbar-collapse" id="navbarNavDarkDropdown">
	  <ul class="navbar-nav">
		<li class="nav-item dropdown">
		  <button class="btn btn-dark dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
			Dropdown
		  </button>
		  <ul class="dropdown-menu dropdown-menu-dark">
			<li><a class="dropdown-item" href="javascript:void(0);">Action</a></li>
			<li><a class="dropdown-item" href="javascript:void(0);">Another action</a></li>
			<li><a class="dropdown-item" href="javascript:void(0);">Something else here</a></li>
		  </ul>
		</li>
	  </ul>
	</div>
  </div>
</nav>

Centered

Make the dropdown menu centered below the toggle with .dropdown-center on the parent element.


<div class="dropdown-center">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
	Centered dropdown
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Action two</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Action three</a></li>
  </ul>
</div>

Dropup

Make the dropup menu centered above the toggle with .dropup-center on the parent element


<!-- Default dropup button -->
<div class="btn-group dropup">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
	Dropup
  </button>
  <ul class="dropdown-menu">
	<!-- Dropdown menu links -->
  </ul>
</div>

<!-- Split dropup button -->
<div class="btn-group dropup">
  <button type="button" class="btn btn-secondary">
	Split dropup
  </button>
  <button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
	<span class="visually-hidden">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu">
	<!-- Dropdown menu links -->
  </ul>
</div>

Dropup centered

Make the dropup menu centered above the toggle with .dropup-center on the parent element.


<div class="dropup-center dropup">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
	Centered dropup
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Action</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Action two</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Action three</a></li>
  </ul>
</div>

Dropend

Trigger dropdown menus at the right of the elements by adding .dropend to the parent element.


<!-- Default dropend button -->
<div class="btn-group dropend">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
    Dropend
  </button>
  <ul class="dropdown-menu">
    <!-- Dropdown menu links -->
  </ul>
</div>

<!-- Split dropend button -->
<div class="btn-group dropend">
  <button type="button" class="btn btn-secondary">
    Split dropend
  </button>
  <button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
    <span class="visually-hidden">Toggle Dropend</span>
  </button>
  <ul class="dropdown-menu">
    <!-- Dropdown menu links -->
  </ul>
</div>

Dropstart

Trigger dropdown menus at the left of the elements by adding .dropstart to the parent element.


<!-- Default dropstart button -->
<div class="btn-group dropstart">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
    Dropstart
  </button>
  <ul class="dropdown-menu">
    <!-- Dropdown menu links -->
  </ul>
</div>

<!-- Split dropstart button -->
<div class="btn-group dropstart">
  <button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
    <span class="visually-hidden">Toggle Dropstart</span>
  </button>
  <ul class="dropdown-menu">
    <!-- Dropdown menu links -->
  </ul>
  <button type="button" class="btn btn-secondary">
    Split dropstart
  </button>
</div>

Alignment options

Taking most of the options shown above, here’s a small kitchen sink demo of various dropdown alignment options in one place.


<div class="btn-group">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
	Dropdown
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
	Right-aligned menu
  </button>
  <ul class="dropdown-menu dropdown-menu-end">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" data-bs-display="static" aria-expanded="false">
	Left-aligned, right-aligned lg
  </button>
  <ul class="dropdown-menu dropdown-menu-lg-end">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" data-bs-display="static" aria-expanded="false">
	Right-aligned, left-aligned lg
  </button>
  <ul class="dropdown-menu dropdown-menu-end dropdown-menu-lg-start">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group dropstart">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
	Dropstart
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group dropend">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
	Dropend
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group dropup">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
	Dropup
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

Auto close behavior

By default, the dropdown menu is closed when clicking inside or outside the dropdown menu. You can use the autoClose option to change this behavior of the dropdown.


<div class="btn-group">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-auto-close="true" aria-expanded="false">
	Default dropdown
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-auto-close="inside" aria-expanded="false">
	Clickable inside
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-auto-close="outside" aria-expanded="false">
	Clickable outside
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

<div class="btn-group">
  <button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-auto-close="false" aria-expanded="false">
	Manual close
  </button>
  <ul class="dropdown-menu">
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
	<li><a class="dropdown-item" href="javascript:void(0);">Menu item</a></li>
  </ul>
</div>

Status Dropdown


<div class="dropdown dropdown-badge dropdown-sm">
  <button type="button" class="btn btn-xs dropdown-toggle btn-warning" data-bs-toggle="dropdown" aria-expanded="false">
    Pending
  </button>
  <ul class="dropdown-menu dropdown-badge-menu">
    <li><a class="dropdown-item" data-badge="btn-warning" href="javascript:void(0);">Pending</a></li>
    <li><a class="dropdown-item" data-badge="btn-success" href="javascript:void(0);">Success</a></li>
    <li><a class="dropdown-item" data-badge="btn-danger" href="javascript:void(0);">Rejected</a></li>
  </ul>
</div>
<div class="dropdown dropdown-badge dropdown-sm">
  <button type="button" class="btn btn-xs light dropdown-toggle btn-warning" data-bs-toggle="dropdown" aria-expanded="false">
    Pending
  </button>
  <ul class="dropdown-menu dropdown-badge-menu">
    <li><a class="dropdown-item" data-badge="btn-warning" href="javascript:void(0);">Pending</a></li>
    <li><a class="dropdown-item" data-badge="btn-success" href="javascript:void(0);">Success</a></li>
    <li><a class="dropdown-item" data-badge="btn-danger" href="javascript:void(0);">Rejected</a></li>
  </ul>
</div>