New to Kendo UI for Vue? Start a free 30-day trial

Titlebar

Updated on Oct 27, 2026

The Dialog titlebar displays a title and a built-in Close button. You can set a plain text title, replace the titlebar content with icons or custom components, hide the titlebar, or hide the Close button.

Setting a Plain Text Title

To display a text string in the Dialog titlebar, set the title property. This is the fastest way to label a confirmation, alert, or informational Dialog.

vue
<Dialog :title="'Unsaved Changes'" />

The following example demonstrates a Dialog with a plain text title.

Example
View Source
Loading ...

Adding Icons and Custom Content

To add icons, images, or any Vue component to the titlebar, use the title-render property. It accepts a Vue component, a render function, or a slot name. The custom content renders inside the titlebar next to the built-in Close button.

vue
<Dialog :title-render="'myTemplate'">
  <template #myTemplate>
    <span>Print this page</span>
  </template>
</Dialog>

The following example demonstrates a Dialog with an icon and custom text in the titlebar.

Example
View Source
Loading ...

Hiding the Titlebar

If you specify neither title nor title-render, the Dialog renders without a titlebar. As a result, the Dialog also does not render a Close button. This suits use cases where the Dialog content provides its own visual context—such as marketing overlays or media prompts.

The following example demonstrates a Dialog without a titlebar.

Example
View Source
Loading ...

Hiding the Close Button

By default, the titlebar renders a Close button. To remove it, set the close-icon property to false.

vue
<Dialog :title="'Terms and Conditions'" :close-icon="false" />

The close-icon property controls only the visibility of the button. The close event still fires when the user presses Esc and a close listener is attached. To require an explicit decision, do not hide the Dialog in the handler, and provide action buttons for the user to respond with.

Use this feature when a dismissal without a decision is not acceptable, for example:

  • Accepting terms and conditions before proceeding.
  • Confirming or canceling a destructive action such as deleting a record.
  • Completing a required step in a wizard or multi-step workflow.
  • Acknowledging a critical system message that requires an explicit response.