Documentation

Button group

Group a series of buttons together on a single line or stack them in a vertical column.

Basic example

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

<div class="btn-group" role="group" aria-label="Basic example">
<button type="button" class="btn btn-primary"> Left </button>
<button type="button" class="btn btn-primary"> Middle </button>
<button type="button" class="btn btn-primary"> Right </button>
</div>

These classes can also be added to groups of links, as an alternative to the .nav navigation components.

<div class="btn-group">
<a href="#" class="btn btn-primary active" aria-current="page">Active link</a>
<a href="#" class="btn btn-primary">Link</button>
<a href="#" class="btn btn-primary">Link</a>
</div>

Mixed styles

<div class="btn-group" role="group" aria-label="Basic mixed styles example">
<button type="button" class="btn btn-danger">Left</button>
<button type="button" class="btn btn-warning">Middle</button>
<button type="button" class="btn btn-success">Right</button>
</div>

Outlined styles

<div class="btn-group" role="group" aria-label="Basic outlined example">
<button type="button" class="btn btn-outline-primary">Left</button>
<button type="button" class="btn btn-outline-primary">Middle</button>
<button type="button" class="btn btn-outline-primary">Right</button>
</div>

Checkbox and radio button groups

Combine button-like checkbox and radio toggle buttons into a seamless looking button group.

<div class="btn-group" role="group" aria-label="Basic checkbox toggle button group">
<input type="checkbox" class="btn-check" id="btncheck1" autocomplete="off">
<label class="btn btn-outline-primary" for="btncheck1">Checkbox 1 </label>

<input type="checkbox" class="btn-check" id="btncheck2" autocomplete="off">
<label class="btn btn-outline-primary" for="btncheck2">Checkbox 2 </label>

<input type="checkbox" class="btn-check" id="btncheck3" autocomplete="off">
<label class="btn btn-outline-primary" for="btncheck3">Checkbox 3 </label>
</div>
<div class="btn-group" role="group" aria-label="Basic radio toggle button group">
<input type="radio" class="btn-check" name="btnradio" id="btnradio1" autocomplete="off" checked>
<label class="btn btn-outline-primary" for="btnradio1">Radio 1 </label>

<input type="radio" class="btn-check" name="btnradio" id="btnradio2" autocomplete="off" checked>
<label class="btn btn-outline-primary" for="btnradio2">Radio 2 </label>

<input type="radio" class="btn-check" name="btnradio" id="btnradio3" autocomplete="off" checked>
<label class="btn btn-outline-primary" for="btnradio3">Radio 3 </label>
</div>

Button toolbar

Combine sets of button groups into button toolbars for more complex components. Use utility classes as needed to space out groups, buttons, and more.

<div class="btn-group me-2" role="group" aria-label="First group">
<button type="button" class="btn btn-primary"> 1 </button>
<button type="button" class="btn btn-primary"> 2 </button>
<button type="button" class="btn btn-primary"> 3 </button>
</div>

Feel free to mix input groups with button groups in your toolbars. Similar to the example above, you’ll likely need some utilities though to space things properly.

<div class="btn-group me-2" role="group" aria-label="First group">
<button type="button" class="btn outline-secondary"> 1 </button>
<button type="button" class="btn outline-secondary"> 2 </button>
<button type="button" class="btn outline-secondary"> 3 </button>
</div>
<div class="input-group">
<div class="input-group-text" id="btnGroupAddon2">@</div>
<input type="text" class="form-control" placeholder="Input group example" aria-label="Input group example" aria-describedby="btnGroupAddon2">
</div>

Sizing

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





<div class="btn-group btn-group-lg" role="group" aria-label="">
<button type="button" class="btn btn-outline-secondary"> Left </button>
</div>
<div class="btn-group " role="group" aria-label="">
<button type="button" class="btn btn-outline-secondary"> Middle </button>
</div>
<div class="btn-group btn-group-sm" role="group" aria-label="">
<button type="button" class="btn btn-outline-secondary"> Right </button>
</div>

Custom Button Group

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

<div class="btn-group iq-qty-btn me-4" data-qty="btn" role="group">
    <button type="button" class="btn btn-sm btn-outline-primary iq-quantity-minus">
        <svg xmlns="http://www.w3.org/2000/svg" width="6" height="3" viewBox="0 0 6 3" fill="none">
            <path d="M5.22727 0.886364H0.136364V2.13636H5.22727V0.886364Z" fill="currentColor"></path>
        </svg>
    </button>
    <input type="text" class="btn btn-sm btn-outline-primary input-display" data-qty="input" pattern="^(0|[1-9][0-9]*)$" minlength="1" maxlength="2" value="2" title="Qty" readonly>
    <button type="button" class="btn btn-sm btn-outline-primary iq-quantity-plus">
        <svg xmlns="http://www.w3.org/2000/svg" width="9" height="8" viewBox="0 0 9 8" fill="none">
            <path d="M3.63636 7.70455H4.90909V4.59091H8.02273V3.31818H4.90909V0.204545H3.63636V3.31818H0.522727V4.59091H3.63636V7.70455Z" fill="currentColor"></path>
        </svg>
    </button>
</div>
<div class="btn-group iq-qty-btn me-4" data-qty="btn" role="group">
    <button type="button" class="btn btn-sm btn-outline-secondary iq-quantity-minus">
        <svg xmlns="http://www.w3.org/2000/svg" width="6" height="3" viewBox="0 0 6 3" fill="none">
            <path d="M5.22727 0.886364H0.136364V2.13636H5.22727V0.886364Z" fill="currentColor"></path>
        </svg>
    </button>
    <input type="text" class="btn btn-sm btn-outline-secondary input-display" data-qty="input" pattern="^(0|[1-9][0-9]*)$" minlength="1" maxlength="2" value="6" title="Qty" readonly>
    <button type="button" class="btn btn-sm btn-outline-secondary iq-quantity-plus">
        <svg xmlns="http://www.w3.org/2000/svg" width="9" height="8" viewBox="0 0 9 8" fill="none">
            <path d="M3.63636 7.70455H4.90909V4.59091H8.02273V3.31818H4.90909V0.204545H3.63636V3.31818H0.522727V4.59091H3.63636V7.70455Z" fill="currentColor"></path>
        </svg>
    </button>
</div>
<div class="btn-group iq-qty-btn me-4 mt-1 mt-sm-0" data-qty="btn" role="group">
    <button type="button" class="btn btn-sm btn-outline-light iq-quantity-minus">
        <svg xmlns="http://www.w3.org/2000/svg" width="6" height="3" viewBox="0 0 6 3" fill="none">
            <path d="M5.22727 0.886364H0.136364V2.13636H5.22727V0.886364Z" fill="currentColor"></path>
        </svg>
    </button>
    <input type="text" class="btn btn-sm btn-outline-light input-display" data-qty="input" pattern="^(0|[1-9][0-9]*)$" minlength="1" maxlength="2" value="1" title="Qty" readonly>
    <button type="button" class="btn btn-sm btn-outline-light iq-quantity-plus">
        <svg xmlns="http://www.w3.org/2000/svg" width="9" height="8" viewBox="0 0 9 8" fill="none">
            <path d="M3.63636 7.70455H4.90909V4.59091H8.02273V3.31818H4.90909V0.204545H3.63636V3.31818H0.522727V4.59091H3.63636V7.70455Z" fill="currentColor"></path>
        </svg>
    </button>
</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 group with nested dropdown">
<button type="button" class="btn btn-primary"> 1 </button>
<button type="button" class="btn btn-primary"> 2 </button>
<div>
    <button id="btnGroupDrop1" type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">  Dropdown </button>
    <ul class="dropdown-menu" aria-labelledby="btnGroupDrop1">>
        <li><a class="dropdown-item" href="#"> Dropdown link </a></li>
        <li><a class="dropdown-item" 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" role="group" aria-label="Button group with nested dropdown">
<button type="button" class="btn btn-secondary"> Button </button>
<button type="button" class="btn btn-secondary"> Button </button>
<div>
    <button id="btnGroupDrop1" type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">  Dropdown </button>
    <ul class="dropdown-menu" aria-labelledby="btnGroupDrop1">>
        <li><a class="dropdown-item" href="#"> Dropdown link </a></li>
        <li><a class="dropdown-item" href="#"> Dropdown link </a></li>
    </ul>
</div>
</div>