Standard select boxes

Use .selectpickerclass on select element to convert it to Bootstrap Select.

<select class="selectpicker"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Select boxes with optgroups

Add options inside the optgroupsto for group options

<select class="selectpicker"><optgroup label="Picnic"><option>Mustard</option><option>Ketchup</option><option>Relish</option></optgroup><optgroup label="Camping"><option>Tent</option><option>Flashlight</option><option>Toilet Paper</option></optgroup></select>

Multiple select boxes

Add multiselectattribute to for multi-selection

<select class="selectpicker" multiple><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Live search

You can add a search input by passing data-live-search="true"attribute

<select class="selectpicker" data-live-search="true"><option>Fries</option><option>Burger,Shake and a Smile</option><option>Sugar,Spice and all things nice</option></select>

Keywords

Add key words to options to improve their searchability using data-tokens.

<select class="selectpicker" data-live-search="true"><option data-tokens="ketchup mustard">Hot Dog</option><option data-tokens="mustard">Burger,Shake and a Smile</option><option data-tokens="frosting">Sugar,Spice and all things nice</option></select>

Limit the number of selections

Limit the number of options that can be selected via the data-max-options.

<select class="selectpicker" multiple data-max-options="2"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Limit the number of selections in groups

Limit the number of group that can be selected using maxOptionsText.

<select class="selectpicker" multiple><optgroup label="Condiments" data-max-options="2"><option>ustard^</option><option>etchup^</option><option>elish^</option></optgroup><optgroup label="Breads" data-max-options="2"><option>lain^</option><option>teamed^</option><option>oasted^</option></optgroup></select>

Placeholder

Using the titleattribute will set the default placeholder.

<select class="selectpicker" multiple title="Choose options"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Selected text

Set the titleattribute on individual options to display alternative text when the option is selected

<select class="selectpicker"><option title="Combo 1">Hot Dog,Fries and a Soda</option><option title="Combo 2">Burger,Shake and a Smile</option><option title="Combo 3">Sugar,Spice and all things nice</option></select>

Selected text format

Specify how the selection is displayed with the data-selected-text-formatattribute on a multiple select

<select class="selectpicker" multiple data-selected-text-format="count"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Selected text format

count>x:Where x is the number of items selected when the display format changes from values to count.

<select class="selectpicker" multiple data-selected-text-format="count > 3"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Onions</option></select>

Style individual options

Classes and styles added to options are transferred to the select box.

<select class="selectpicker"><option>Mustard</option><option class="bg-danger">Ketchup</option><option style="background: #8dbf42; color: #fff;">Relish</option></select>

Custom content

Insert custom HTML into the option with the data-contentattribute

<select class="selectpicker"><option data-content="<span class='badge badge-primary'>Primary</span>">Primary</option><option data-content="<span class='badge badge-secondary'>Secondary</span>">Secondary</option><option data-content="<span class='badge badge-success'>Success</span>">Success</option><option data-content="<span class='badge badge-warning'>Warning</span>">Warning</option></select>

Show Subtext

Add subtext to an option or optgroup with the data-subtextattribute.

<select class="selectpicker" data-show-subtext="true"><option data-subtext="French's">Mustard</option><option data-subtext="Heinz">Ketchup</option><option data-subtext="Sweet">Relish</option><option data-subtext="Miracle Whip">Mayonnaise</option><option data-divider="true">divider</option><option data-subtext="Honey">Barbecue Sauce</option><option data-subtext="Ranch">Salad Dressing</option><option data-subtext="Sweet & Spicy">Tabasco</option><option data-subtext="Chunky">Salsa</option></select>

Menu size

The size of the menu can also be specifed using the data-sizeattribute.

<select class="selectpicker" data-size="5"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option></select>

Select / Deselect all options

Adds two buttons to the top of the menu - Select All& Deselect Allwith data-actions-box="true".

<select class="selectpicker" multiple data-actions-box="true"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Divider

Add data-divider="true"to an option to turn it into a divider.

<select class="selectpicker"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option><option>Mustard</option><option>Ketchup</option><option>Relish</option><option data-divider="true">divider</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option></select>

Menu header

Add a header to the dropdown menu data-header="Select a condiment"

<select class="selectpicker" data-header="Select a condiment" data-size="5"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option><option>Barbecue Sauce</option><option>Salad Dressing</option><option>Tabasco</option><option>Salsa</option></select>

Dropup menu

Add dropupAutoto automatically change postion according to window.

<select class="selectpicker dropup"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Mayonnaise</option></select>

Disabled

Disabled select box

Disable Select box using disabledattribute on selectelement.

<select class="selectpicker" disabled><option>Mustard</option><option>Ketchup</option><option>Relish</option></select>

Disabled options

Disable Select Option using disabledattribute on select optionelement.

<select class="selectpicker"><option>Mustard</option><option disabled>Ketchup</option><option>Relish</option></select>

Disabled options groups

Disable Select Group using disabledattribute on select optgroupelement

<select class="selectpicker test"><optgroup label="Picnic" disabled><option>Mustard</option><option>Ketchup</option><option>Relish</option></optgroup><optgroup label="Camping"><option>Tent</option><option>Flashlight</option><option>Toilet Paper</option></optgroup></select>

Styling

Styling

You can set the button classes via the data-styleattribute

<select class="selectpicker mb-4 ml-2" data-style="custom-styling btn btn-outline-primary"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Onions</option></select>

Width

Grid

Wrap selects in grid columns,or any custom parent element,to easily enforce desired widths.

<div class="row"><div class="col-sm-3 col-12"><div class="form-group"><select class="selectpicker form-control"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select></div></div><div class="col-sm-9 col-12"><div class="form-group"><select class="selectpicker form-control"><option>Mustard</option><option>Ketchup</option><option>Relish</option></select></div></div></div>

Custom Width

use the data-widthattribute to set the width of the select

Data Width = "fit"
Data Width = "200px"
Data Width = "75%"
================== Data Width = "fit" ================== <div class="col-sm-12"><select class="selectpicker mb-4" data-width="fit"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Onions</option></select></div>================== Data Width = "200px" ================== <div class="col-sm-12"><select class="selectpicker mb-4" data-width="200px"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Onions</option></select></div>================== Data Width = "75%" ================== <div class="col-sm-12"><select class="selectpicker mb-4" data-width="75%"><option>Mustard</option><option>Ketchup</option><option>Relish</option><option>Onions</option></select></div>