Bootstrap JS Modal

Modal CSS Classes

For a tutorial about Modals, read our Bootstrap Modal Tutorial.

Class	Description	Example
`.modal`	Creates a modal	Try it
`.modal-content`	Styles the modal properly with border, background-color, etc. Use this class to add the modal's header, body, and footer	Try it
`.modal-dialog-centered`	Centers the modal vertically and horizontally within the page	Try it
`.modal-dialog-scrollable`	Adds a scrollbar inside the modal	Try it
`.modal-header`	Defines the style for the header of the modal	Try it
`.modal-body`	Defines the style for the body of the modal	Try it
`.modal-footer`	Defines the style for the footer in the modal. Note: This area is right-aligned by default. To change this, add the justify-content-start or justify-content-center together with the .modal-footer class	Try it
`.modal-sm`	Specifies a small modal	Try it
`.modal-lg`	Specifies a large modal	Try it
`.fade`	Adds an animation/transition effect which fades the modal in and out	Try it

Trigger the Modal Via data-* Attributes

Add data-toggle="modal" and data-target="#modalID" to any element.

Note: For <a> elements, omit data-target, and use href="#modalID" instead:

Example

<button type="button" data-toggle="modal" data-target="#myModal">Open Modal</button>


<a data-toggle="modal" href="#myModal">Open Modal</a>


<p data-toggle="modal" data-target="#myModal">Open Modal</p>

Try it Yourself »

Trigger Via JavaScript

Enable manually with:

Example

$("#myModal").modal()

Try it Yourself »

Modal Options

Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-backdrop="".

Name	Type	Default	Description	Try it
backdrop	boolean or the string "static"	true	Specifies whether the modal should have a dark overlay: true - dark overlay false - no overlay (transparent) If you specify the value "static", it is not possible to close the modal when clicking outside of it	Using JS Using data
keyboard	boolean	true	Specifies whether the modal can be closed with the escape key (Esc): true - the modal can be closed with Esc false - the modal cannot be closed with Esc	Using JS Using data
show	boolean	true	Specifies whether to show the modal when initialized	Using JS Using data

Name

Type

Default

Description

Try it

backdrop

boolean or the string "static"

true

Specifies whether the modal should have a dark overlay:

true - dark overlay
false - no overlay (transparent)

If you specify the value "static", it is not possible to close the modal when clicking outside of it

Using JS Using data

keyboard

boolean

true

Specifies whether the modal can be closed with the escape key (Esc):

true - the modal can be closed with Esc
false - the modal cannot be closed with Esc

Using JS Using data

show

boolean

true

Specifies whether to show the modal when initialized

Using JS Using data

Modal Methods

The following table lists all available modal methods.

Method	Description	Try it
.modal(options)	Activates the content as a modal. See options above for valid values	Try it
.modal("toggle")	Toggles the modal	Try it
.modal("show")	Opens the modal	Try it
.modal("hide")	Hides the modal	Try it

Modal Events

The following table lists all available modal events.

Event	Description	Try it
show.bs.modal	Occurs when the modal is about to be shown	Try it
shown.bs.modal	Occurs when the modal is fully shown (after CSS transitions have completed)	Try it
hide.bs.modal	Occurs when the modal is about to be hidden	Try it
hidden.bs.modal	Occurs when the modal is fully hidden (after CSS transitions have completed)	Try it