ui/docs/content/6.overlays/1.modal.md

---
github: true
description: Display a modal within your application.
headlessui:
  label: 'Dialog'
  to: 'https://headlessui.com/vue/dialog'
---

## Usage

::component-example
#default
:modal-example-basic

#code
```vue
<script setup>
const isOpen = ref(false)
</script>

<template>
  <div>
    <UButton label="Open" @click="isOpen = true" />

    <UModal v-model="isOpen">
      <!-- Content -->
    </UModal>
  </div>
</template>
```
::

You can put a [Card](/layout/card) component inside your Modal to handle forms and take advantage of `header` and `footer` slots:

::component-example
#default
:modal-example-card

#code
```vue
<script setup>
const isOpen = ref(false)
</script>

<template>
  <div>
    <UButton label="Open" @click="isOpen = true" />

    <UModal v-model="isOpen">
      <UCard :ui="{ divide: 'divide-y divide-gray-100 dark:divide-gray-800' }">
        <template #header>
          <!-- Content -->
        </template>

        <!-- Content -->

        <template #footer>
          <!-- Content -->
        </template>
      </UCard>
    </UModal>
  </div>
</template>
```
::

## Props

:component-props

## Preset

:component-preset