The Quasar Modal component is a UI overlay, which offers extended screen space to allow the user to get more work done. Modals are used for such things as login or signup dialogs, for message composition windows or extended option selections, like offering a list of users to be friends with.

During development open/close might not be triggered because of HMR. Best would be before updating source files to close the Modal. This way HMR will correctly do its job. In production this scenario can’t happen, so no bugs for final product.

Basic Usage

Below you’ll find the code to a very basic modal:

<q-modal ref="basicModal">
<h4>Basic Modal</h4>
<q-btn color="primary" @click="$refs.basicModal.close()">Close</q-btn>

Modals are responsive to the width of the window (see demo on a desktop and resize browser window). Sometimes you need to always have a Modal maximized or minimized regardless of window width, so to do this, Quasar offers the minimized and maximized props:

<q-modal maximized>

Toggle through v-model

<q-btn color="primary" @click="open = true" label="Open" />
<q-modal v-model="open">
<q-btn color="primary" @click="open = false" label="Close" />

export default {
data () {
return {
open: false

Vue Properties

content-cssObject/Array/StringApplies CSS style to Modal container. Use Object or Array of Object when also specifying position prop.
content-classesObject/Array/StringClasses to apply to Modal inner content.
transitionStringVue transition to use. Quasar comes with a q-modal transition out of the box. But you can write your own Vue transitions using CSS and use them.
no-backdrop-dismissBooleanDisable Modal dismissal by clicking/tapping on backdrop.
no-esc-dismissBooleanDisable Modal dismissal by hitting Escape key.
positionStringStick Modal to one of the screen edges (top, right, bottom, left).
position-classesStringSpace delimited CSS classes that overwrite the default ‘items-center justify-center’ classes. Gets overridden by position if present.
minimizedBooleanAlways minimized regardless of screen width.
maximizedBooleanAlways maximized regardless of screen width.
enter-classStringenter transition class name
leave-classStringleave transition class name

Vue Methods

If the modal includes buttons or other clickable items which cause navigation or other events to be raised within your app, it’s vital to use the callback feature of these methods, and what’s passed in must be a function. So, if you want to close a QModal and then navigate to a new route, the code must look something like this:

<q-modal ref="myRef"
<q-btn @click="$refs.myRef.close(() => $router.push('/newroute'))" />

openOpen Modal. Takes one optional Function parameter to trigger after Modal is opened.
closeClose Modal. Takes one optional Function parameter to trigger after Modal is closed.
toggleToggle open/close Modal state. Takes one optional Function parameter to trigger after Modal is toggled.

Vue Events

Event NameDescription
@openTriggered right after Modal is opened.
@closeTriggered right after Modal is closed.
@escape-keyTriggered if the Modal is dismissed with the Escape key on desktops.


Capturing Events


Styling Modal

<q-modal :content-css="{padding: '50px'}">

Sticking Modal to an Edge

<q-modal position="left">

When making layout inside a modal, Quasar has a special component called QModalLayout (described in next section), which takes care of any needed structure.

Do NOT use QLayout inside a QModal. Instead, use the simplified QModalLayout.

<q-modal ref="layoutModal" :content-css="{minWidth: '80vw', minHeight: '80vh'}">
<q-toolbar slot="header">
<q-btn flat @click="$refs.layoutModal.close()">
<q-icon name="keyboard_arrow_left" />
<div class="q-toolbar-title">

<q-toolbar slot="header">
<q-search inverted v-model="search" color="none" />

<q-toolbar slot="footer">
<div class="q-toolbar-title">

<div class="layout-padding">

<q-btn color="primary" @click="$refs.layoutModal.close()">Close</q-btn>
<p class="caption" v-for="n in 15">This is a Modal presenting a Layout.</p>


QModalLayout has two slots (header and footer) and the following properties which can be either String, Object or Array:

header-styleStyle applied to header.
header-classCSS classes applied to header.
content-styleStyle applied to content (between header and footer).
content-classCSS classes applied to content (between header and footer).
footer-styleStyle applied to footer.
footer-classCSS classes applied to footer.


<q-modal .....>
header-style="min-height: 100px"
content-class="{'bg-primary': isPrimary, 'some-class': someBoolean}"
footer-class="bg-primary some-class"
footer-style="{fontSize: '24px', fontWeight: 'bold'}"
inject header and/or footer slots here
1. <div slot="header">...</div>
2. <q-toolbar slot="header">...</q-toolbar>

all other elements not using header or footer slot
is considered content