News
Game
Guides
Downloads
Versions
/dialog
COMMANDS CHAT & DISPLAY CHEATS · LEVEL 2 Added in 1.21.6

/dialog command in Minecraft

/dialog opens a dialog window on the screen of chosen players, or closes it. Dialogs are defined in data packs and can show text, buttons and choices, so servers and map makers use them for menus, rules or confirmations.

Syntax

/dialog clear <targets>
/dialog show <targets> <dialog>
ArgumentExpectsWhat it does
targetsPlayer selectorone or severalPlayers who see or lose the dialog: @a, @p, @s or a player name.
dialogDialogDialog ID, such as minecraft:server_links or blockaria:welcome from your data pack.

Examples

Show the server links

/dialog show @a minecraft:server_links

Opens the built-in server links dialog for every player.

Java 26.3

Open your own dialog

/dialog show @p blockaria:welcome

Opens the dialog stored in data/blockaria/dialog/welcome.json for the nearest player.

Java 26.3

Close all dialogs

/dialog clear @a

Closes the open dialog on every player's screen.

Java 26.3
Build your command

Fill in the fields, then copy the command.

Command generator

Where dialogs come from

Each dialog is a JSON file in the dialog folder of a data pack, for example data/blockaria/dialog/welcome.json, opened with dialog show @p blockaria:welcome. The available types are notice, confirmation, multi_action, dialog_list and server_links. The built-in dialogs minecraft:custom_options and minecraft:quick_actions list the dialogs of two tags, empty by default.

Tips

dialog clear closes the dialog open on the screen. Manage your packs with /datapack. The command needs permission level 2. For a simple message in chat instead of a window, use /tellraw.

✓ Checked in Java Edition 26.3 · updated 2 November 2026

/dialog: FAQ

Where do I put a dialog file?

In the dialog folder of a data pack, for example data/blockaria/dialog/welcome.json. Its ID is then blockaria:welcome.

How do I close a dialog for a player?

Run /dialog clear followed by the player, for example /dialog clear @a. It closes the dialog open on their screen.

How do I use /dialog?

Type it in the chat with cheats on: /dialog clear <targets>.

Who can use /dialog?

Cheats on, or operator level 2.

Since when does /dialog exist?

It is in the official command tree since Java Edition 1.21.6.

Related commands