Commands/dialog
Minecraft Wiki article. Categories: Java_Edition, Commands
📌 Mirrored from Minecraft Wiki
This article is reproduced from Commands/dialog on the Minecraft Wiki. Mirrored from revision 3712412. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.
On this page
This feature is exclusive to Java Edition.
/dialog{
"title": "<code>/dialog</code>",
"rows": [
{
"field": "2",
"label": "(link to Permission level article, displayed as Permission level<br>required)"
},
{
"field": "(link to Commands#Cheats article, displayed as Cheats) enabled",
"label": "(link to Commands#Restrictions article, displayed as Restrictions)"
}
],
"invimages": [],
"images": []
}
Manages dialog screens displayed to players. Allows server operators to show custom or predefined dialogs in data pack to specified players, and clear any displayed dialogs on their screen.
Syntax
/dialog show <targets> <dialog>/dialog clear <targets>- Clears currently displayed dialogs for specified players.
Arguments
<targets>: entity
- Specifies the players whose dialog is shown or cleared.
- Must be a player name, a target selector or a UUID. And the target selector must be of player type.
<dialog>: dialog
- Specifies the dialog to show to the players. This argument is only used with
/dialog show. - Specifies a dialog with a resource location or in SNBT format. Must be a valid dialog definition in SNBT format, or a resource location of an existing dialog (an entry in
minecraft:dialogregistry). For NBT tag, if it is a string tag, the tag is also parsed into a resource location and resolved into an existing dialog; otherwise, the tag is parsed as a new dialog definition.
Result
| Command | Trigger | Java Edition |
|---|---|---|
| Any | The command is incomplete, or any argument is not specified correctly. | Unparseable |
/dialog (show|clear) <targets> | targets is a target selector that includes any entities other than the player. | Failed |
/dialog show <targets> <dialog> | dialog is not a valid dialog SNBT, or dialog does not exist in minecraft:dialog registry (usually in a data pack). | Failed |
| Any | Otherwise | Successful |
Output
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| Any | Java Edition | On fail | 0 | 0 | 0 |
| On success | 1 | 1 | the number of targeted players |
Examples


- To show the nearest player a dialog located at
data/custom/dialog/example/test.jsonin a loaded data pack:/dialog show @p custom:example/test
- To show all players the built-in
minecraft:server_linksdialog:/dialog show @a minecraft:server_links
- To show nearest players a notice dialog with title "Hello" and an "Ok" button in the footer:
/dialog show @p {type:"minecraft:notice",title:"Hello"}
- To show all players a simple confirmation dialog with two action buttons with the label "Yes please" and "Nope". If the player presses "Yes please", the game runs a command to give the player a diamond, otherwise, if they press "Nope", the game closes the dialog:
/dialog show @a {type:"minecraft:confirmation",title:"Give yourself diamond?",yes:{label:"Yes please","action":{"type":"run_command","command":"give @s diamond"}},no:{label:"Nope"}}
- To clear any currently visible dialogs for all players:
/dialog clear @a
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.21.6 | 25w20a | Added /dialog | |||||
Added minecraft:custom_options and minecraft:server_links as blank built-in dialogs. | |||||||
| Pre-Release 1 | Added minecraft:quick_actions as a blank built-in dialog. | ||||||
Gallery
-
An entity summoner made and shown off by u/SmoothTurtle872 on Reddit
References
- ↑ "Tears For Facing Your Fears | Snapshot 25W20A" – xisumavoid on YouTube, May 13, 2025
Navigation
Sources
- Commands/dialog — Minecraft Wiki, CC BY-NC-SA 3.0, revision 3712412.