---

Dropdowns

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

Overview

Dropdowns are toggleable, contextual overlays for displaying lists of links and more. They are made interactive with the included Bootstrap dropdown JavaScript plugin. They are toggled by clicking, not by hovering; this is an intentional design decision.
Dropdowns are built on a third party library, Popper, which provides dynamic positioning and viewport detection. Be sure to include popper.min.js before Bootstrap JavaScript or use 

bootstrap.bundle.min.js

 / 

bootstrap.bundle.js

 which contains Popper. Popper is not used to position dropdowns in navbars though as dynamic positioning is not required.

Examples

Wrap the dropdown toggle (your button or link) and the dropdown menu within 

.dropdown

, or another element that declares 

position: relative;

. Dropdowns can be triggered from 

<a>

 or 

<button>

 elements to better fit your potential needs. The examples shown here use semantic 

<ul>

 elements where appropriate, but custom markup is supported.

Single button

Any single 

.btn

 can be turned into a dropdown toggle with some markup changes. Here is how you can put them to work with either 

<button>

 elements.

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.
We use this extra class to reduce the horizontal 

padding

 on either side of the caret by 25% and remove the 

margin-left

 that is added for regular button dropdowns. Those extra changes keep the caret centered in the split button and provide a more appropriately sized hit area next to the main button.

Sizing

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