npm i bootstrap5-toggle


Bootstrap 5 Toggle is a bootstrap plugin/widget that converts checkboxes into toggles.

by Pablo Alcaraz Martínez

4.3.4 (see all)License:MITTypeScript:Not Found
npm i bootstrap5-toggle

GitHub license Latest release JSDelivr Badge NPM Badge Build Test Maintenance Funding Rate this package

Bootstrap 5 Toggle

Bootstrap 5 Toggle is a bootstrap plugin/widget that converts checkboxes into toggles.

Library Distributions

BranchBootstrap SupportLast Release
bootstrap5-toggleBootstrap 5Latest release
bootstrap5-toggle v3.X.XBootstrap 4Latest release


Demos and API Docs:

Demo GIF

Related Bootstrap Puglins

Table of Contents generated with DocToc



JSDelivr Badge

jQuery Interface

<link href="" rel="stylesheet">  
<script src=""></script>

ECMAS Interface

<link href="" rel="stylesheet">  
<script src=""></script>


Latest release


NPM Badge

npm install bootstrap5-toggle


yarn add bootstrap5-toggle


Initialize With HTML

Simply add data-toggle="toggle" to automatically convert a plain checkbox into a bootstrap 5 toggle.

<input id="chkToggle" type="checkbox" data-toggle="toggle">

Initialize With Code

Toggles can also be initialized via JavaScript code.

EX: Initialize id chkToggle with a single line of JavaScript.

<input id="chkToggle" type="checkbox" checked>



  • Options can be passed via data attributes or JavaScript
  • For data attributes, append the option name to data- (ex: data-on="Enabled")
<input type="checkbox" data-toggle="toggle" data-on="Enabled" data-off="Disabled">
<input type="checkbox" id="toggle-two">
  $(function() {
      on: 'Enabled',
      off: 'Disabled'
onstring/html"On"Text of the on toggle
offstring/html"Off"Text of the off toggle
sizestring"normal"Size of the toggle. Possible values are: large, normal, small, mini.
onstylestring"primary"Style of the on toggle. Possible values are: primary, secondary, success, danger, warning, info, light, dark and with outline- prefix
offstylestring"secondary"Style of the off toggle. Possible values are: primary, secondary, success, danger, warning, info, light, dark and with outline- prefix
onvaluestringnullSets on state value
offvaluestringnullSets off state value
stylestringAppends the value to the class attribute of the toggle. This can be used to apply custom styles. Refer to Custom Styles for reference.
widthintegernullSets the width of the toggle. if set to null, width will be auto-calculated.
heightintegernullSets the height of the toggle. if set to null, height will be auto-calculated.
tabindexinteger0Sets the tabindex of the toggle.
tristatebooleanfalseSets tristate support


Methods can be used to control toggles directly.

<input id="toggle-demo" type="checkbox" data-toggle="toggle">
initialize$('#toggle-demo').bootstrapToggle()Initializes the toggle plugin with options
destroy$('#toggle-demo').bootstrapToggle('destroy')Destroys the toggle
on$('#toggle-demo').bootstrapToggle('on')Sets the toggle to 'On' state
off$('#toggle-demo').bootstrapToggle('off')Sets the toggle to 'Off' state
toggle$('#toggle-demo').bootstrapToggle('toggle')Toggles the state of the toggle on/off
enable$('#toggle-demo').bootstrapToggle('enable')Enables the toggle
disable$('#toggle-demo').bootstrapToggle('disable')Disables the toggle
readonly$('#toggle-demo').bootstrapToggle('readonly')Disables the toggle but preserve checkbox enabled
indeterminate$('#toggle-demo').bootstrapToggle('indeterminate')Sets the toggle to 'indeterminate' state
determinate$('#toggle-demo').bootstrapToggle('determinate')Sets the toggle to 'determinate' state


Event Propagation

Note All events are propagated to and from input element to the toggle.

You should listen to events from the <input type="checkbox"> directly rather than look for custom events.

<input id="toggle-event" type="checkbox" data-toggle="toggle">
<div id="console-event"></div>
  $(function() {
    $('#toggle-event').change(function() {
      $('#console-event').html('Toggle: ' + $(this).prop('checked'))

Stopping Event Propagation

Passing true to the on, off, toggle, determinate and indeterminate methods will enable the silent option to prevent the control from propagating the change event in cases where you want to update the controls on/off state, but do not want to fire the onChange event.

<input id="toggle-silent" type="checkbox" data-toggle="toggle">
<button class="btn btn-success" onclick="toggleApiOnSilent()" >On by API (silent)</button>
<button class="btn btn-success" onclick="toggleApiOffSilent()">Off by API (silent)</button>
<button class="btn btn-warning" onclick="toggleApiOnNotSilent()">On by API (not silent)</button>
<button class="btn btn-warning" onclick="toggleApiOffNotSilent()">On by API (not silent)</button>
  function toggleApiOnSilent() {
    $('#toggle-silent').bootstrapToggle('on', true);
  function toggleApiOffSilent() {
    $('#toggle-silent').bootstrapToggle('off', true);
  function toggleApiOnNotSilent() {
  function toggleApiOffNotSilent() {

API vs Input

This also means that using the API or Input to trigger events will work both ways.

<input id="toggle-trigger" type="checkbox" data-toggle="toggle">
<button class="btn btn-success" onclick="toggleApiOn()" >On by API</button>
<button class="btn btn-danger"  onclick="toggleApiOff()">Off by API</button>
<button class="btn btn-success" onclick="toggleInpOn()" >On by Input</button>
<button class="btn btn-danger"  onclick="toggleInpOff()">Off by Input</button>
  function toggleApiOn() {
  function toggleApiOff() {
  function toggleInpOn() {
    $('#toggle-trigger').prop('checked', true).change()
  function toggleInpOff() {
    $('#toggle-trigger').prop('checked', false).change()

Collaborators welcom!

GitHub Contributors

¿Do you like the project? Give us a ⭐ in GitHub.