Minecraft:Tooltip: Difference between revisions

Latest revision as of 11:11, 20 October 2026

An example of an item tooltip with enchantments and attributes Template:In

A tooltip contains information that appears when hovering over or focusing on Minecraft:items or certain UI elements.

Item tooltips

When hovering over an Minecraft:item with the cursor while in the Minecraft:inventory or a Minecraft:container screen, a tooltip with the item’s name appears next to the cursor. When playing with touch controls, tapping an item displays its tooltip on the bottom of the screen. Some items display extra information on their tooltips, such as enchantments and Minecraft:shulker box contents. Template:IN, basic item tooltips are also visible in the "Items" section of the Minecraft:statistics menu when hovering over a block or item on the left side of the screen.

Template:IN, advanced tooltips, including item IDs and the exact remaining Minecraft:durability of tools, can be displayed by pressing the Minecraft:debug hotkey Template:Key.

Some information that is visible on tooltips is also shown above the hotbar on the Minecraft:HUD when selecting the item.

Template:IN, tooltip lines that are customizable allow Minecraft:formatting codes and Minecraft:emojis. Obfuscated text is not animated in tooltips, but it is on the HUD.

Description of item tooltip lines

The table below describes all possible tooltip lines, in the order at which they always appear in-game.

In "Content" column, cells with yellow background means the exact text displayed.

Example	Content	Description	ColorTemplate:Note Template:Info needed
File:Tooltip item.png	Item name	The name of the item. Custom item names, for example when renamed in an anvil, are italic, and can have Minecraft:formatting codes.Template:Only Certain items have variable names, such as Minecraft:buckets of tropical fish Template:Only and filled maps, which are not italicized. Shown on the HUD above the hotbar when selecting the item.	Depends on Minecraft:rarity: Common: Template:Color Uncommon: Template:Color Rare: Template:Color Epic: Template:Color
File:Tooltip bundle empty.png	Template:Tc	Shown on Minecraft:bundles when empty.	Template:Color
File:Tooltip bundle.png	Bundle contents	Shown on bundles with items, displays the first 12 item types in slots that can be scrolled over, displaying a second tooltip containing only the selected item name above the bundle tooltip. With 13 item types or more, displays the first 11 items and an unselectable counter of the remaining item quantity. For an overview on the usage of items in a bundle, see Template:Slink.	-
File:Tooltip bundle.png	Bundle fulness bar	A progress bar that can display "Empty", a blue progress, or "Full" with red progress.	-
File:Tooltip description.png	Item descriptionTemplate:Only	Many items have a description about their functionality:Template:Collapse	Template:Color
File:Tooltip description.png	Redstone functionalityTemplate:Only	Items with functionality in Minecraft:redstone circuits can display additional information below the description:Template:Collapse	Template:Color
	Creative inventory sectionTemplate:Only	The name of the Minecraft:Creative inventory tab in which the item appears. Shown only when the player is in Minecraft:Creative mode, and only in the Search Items, Survival Inventory and Saved Hotbars tabs.
File:Tooltip music disc.png	Music disc name	The name of the music disc, e.g. "C418 - strad".	Template:Color
File:Tooltip music disc.png	Template:Tc	Shown when the music disc is queued next in a Minecraft:jukebox playlist.	Template:Color
File:Tooltip disc fragment.png	Template:Tc	Shown on the disc fragment item.	Template:Color
File:Tooltip goat horn.png	Goat horn instrument	The instrument of the goat horn, e.g. "Ponder".	Template:Color
width=120x120 Template:Only	Template:Tc	Description of smithing templates, shown only on smithing template items.
	Template:Note
	Template:Tc
	Applicable items
	Template:Tc
	Ingredients
width=120x120 Template:Only	Painting's name	Minecraft:Painting information when the item is a preset painting variant obtained from the Creative inventory.
	Painting's author
	Painting's dimensions
width=120x120 Template:Only	Tropical fish's pattern	The pattern and base and pattern color displayed on Minecraft:buckets of tropical fish. Bedrock Edition shows this information in the item name.
width=120x120 Template:Only	Tropical fish's base and pattern color
File:Tooltip map.png	Template:Tc	Shown when the Minecraft:map has no map data. In Bedrock Edition, the item name changes to "Unknown Map" instead.
	Map IDTemplate:Only	Shown on maps that do not have a unique name or modification, mainly explorer maps.
	Map levelTemplate:Only	The scale level (0-4) of the map, e.g. "Level 3/4". Shown on any non-explorer filled map.	Template:Color
	Template:Tc	Shown when the map is locked.	Template:Color
	Map scalingTemplate:Only	Additional information about map scaling and level. Only shown with advanced tooltips enabled.
	Map levelTemplate:Only
Template:Only	Number of bees	Number of Minecraft:bee entities inside the Minecraft:beehive or bee nest.
Template:Only	Honey amount	Amount of honey in Minecraft:beehives or Minecraft:bee nests.
File:Tooltip shulker.png	Shulker box contents	Displays the item names of the first 5 item slots in the shulker box followed by the stack size (e.g. "String x64"). If there are more slots filled, this also displays the amount of stacks not shown. (e.g. "and 6 more..."). In Bedrock Edition, this is also shown above the hotbar when selecting the item.	Template:Color
File:Tooltip banner.png	Banner patterns	Displays all (max 6) Minecraft:banner patterns preceded by their color.	Template:Color
File:Tooltip pot.png	Template:Tc	Decorated pot materials, either a pottery sherd item name or "Minecraft:Brick".
	Front side material		Template:Color
	Left side material
	Right side material
	Rear side material
File:Tooltip book.png	Book's author	The author of the written book preceded by "by ". In Bedrock Edition, this can be chosen while signing a book and quill, and can have custom formatting codes.
File:Tooltip book.png	Book's generation	The book's generation, which can be "Original", "Copy of original", or "Copy of a copy".
width=120x120 Template:Only	Projectile name	Shown on Minecraft:crossbows with a charged projectile.
width=120x120 Template:Only	Projectile's tooltip linesTemplate:Note	Shown on Minecraft:crossbows with a charged projectile.
File:Tooltip firework.png	Flight duration	A firework rocket's flight duration, e.g. "Flight Duration: 3".	Template:Color
File:Tooltip firework.png	Firework effects	Shown on firework rockets and Minecraft:firework stars. Each firework star effect is shown as follows, multiple can be on one firework rocket: Shape (Small ball explosion, Large ball explosion, Burst explosion, Star-shaped explosion, or Creeper-shaped explosion) All colors (e.g. Black, Light Blue, Gray, Gray, Lime, Pink) Trail, if applied Twinkle, if applied
width=120x120	Template:Tc	Shown on any Minecraft:potion without effects: water bottle, mundane potion, Minecraft:long mundane potion, thick potion, awkward potion, and their splash and lingering variants. Also shown above the hotbar in Bedrock Edition, in Template:Color.
File:Tooltip effects.png	Effect name	Minecraft:Effect name, level (if higher than 1), and duration, e.g. "Slowness IV (0:20)". Shown on Minecraft:potions, Minecraft:tipped arrows, and suspicious stew in Creative mode. There can be multiple effects. Also shown above the hotbar in Bedrock Edition, in Template:Color.	When positive: Template:Color When negative: Template:Color
	Template:Tc	Attribute information, e.g. "+2.99 Attack Damage". Can only show Speed and Attack Damage.
	Template:Tc
	Attributes
width=120x120 Template:Only	Template:Tc	Shown on Minecraft:armor items with armor trims applied, with the material and used armor trim (e.g. "Quartz Tide Trim").
	Trim pattern
	Trim material
File:Tooltip armor trim.png Template:Only	Trim pattern & material		Depends on used materials: Quartz: Template:Color Iron: Template:Color Netherite: Template:Color Redstone: Template:Color Copper: Template:Color Gold: Template:Color Emerald: Template:Color Diamond: Template:Color Lapis: Template:Color Amethyst: Template:Color Resin: Template:Color
File:Tooltip enchantments.png	Enchantments	Minecraft:Enchantments with level (if higher than 1) applied to the item (e.g. "Feather Falling IV"), can have multiple. Also shown above the hotbar in Bedrock Edition.	Enchantments: Template:Color Curses: Template:Color
File:Tooltip attributes.png	Attributes	Minecraft:Attribute modifier (e.g. "+11 Armor"). In Bedrock Edition shown for Armor, Armor Toughness, Knockback Resistance, Attack Damage, Chop Efficiency, Mining Efficiency, and Dig Efficicency. In Java Edition, shown below lore.	Template:Color
	Template:Tc	The "When..." field specifying the required equipment slot for the attributes to apply.
	Required slotTemplate:Only
File:Tooltip dyed.png	Template:Tc	Shown when the item (leather armor or wolf armor) is dyed.	Template:Color
	Template:Tc	Shown when the item (leather armor or wolf armor) is dyed.	Template:Color
	ColorTemplate:Only	The hexadecimal color of the dye, shown only when advanced tooltips is enabled.
Template:Only	Lore	Custom text shown in tooltip, defined by `minecraft:lore` component. By default it has `"dark_purple"` color and is italicized.
Template:Only	Template:Tc	Shown when item is unbreakable, using the `minecraft:unbreakable` component.
Template:Only	Template:Tc	Indicates that this item has the `minecraft:container_loot` component.Template:Info needed
Template:Only	Template:Tc	Shown in Peaceful mode when item has `id` tag in `minecraft:entity_data` component, pointing to a mob which is not allowed in Peaceful. See this article for more information.
Template:Only	Template:Tc	Shown on Minecraft:monster spawners and Minecraft:trial spawners and has spawn data.
	Template:Tc
	Template:Tc
	Spawner entity name
	Template:Tc	Shows a list of blocks defined in `minecraft:can_break`Template:Only/`can_place_on`Template:Only component that can be mined with this item in Minecraft:Adventure mode.	Template:Color
	Template:Tc
	Breakable blocks
	Template:Tc	Shows a list of blocks defined in `minecraft:can_place_on` component on which this block can be placed in Minecraft:Adventure mode.
	Template:Tc
	Placeable blocks
Template:Only	Durability	Remaining and total Minecraft:durability of the tool item, only shown with advanced tooltips enabled.
Template:Only	Item ID	Internal item ID, only shown with advanced tooltips enabled.
Template:Only	Number of components	Total number of data components, only shown with advanced tooltips enabled.
Template:Only	Template:Tc	Usage warning, shown on block items with `id` tag in `minecraft:block_entity_data` component.
	Template:Tc
	Template:Tc
File:Tooltip cant drop.png Template:Only	Template:Tc	Shown on items with `lock_in_inventory` NBT component. Also shown above the hotbar, in Template:Color (star) and Template:Color.	Template:Color
	Template:Tc
	Template:Tc
	Template:Tc
File:Tooltip cant move.png Template:Only	Template:Tc	Shown on items with `lock_in_slot` NBT component. Also shown above the hotbar, in Template:Color (star) and Template:Color.
	Template:Tc
	Template:Tc
	Template:Tc
	Template:Tc
File:Tooltip not lost.png Template:Only	Template:Tc	Shown on items with `keep_on_death` NBT component. Also shown above the hotbar, in Template:Color.
File:Tooltip data.png Template:Only	Template:Tc	Shown on items obtained using Template:Keys Template:Control, making them contain data (such as a command block with commands).	Template:Color, italicized

Other tooltips

Enchanting table options

File:Enchanting table tooltip creative.png

An enchanting table tooltip in Creative mode

The three enchantment options in an enchanting table, displayed when an enchantable item is added, have tooltips displaying one of the enchantments that are added through this option, formatted like "<Enchantment> <level> . . . ?". The tooltip is italicized Template:In; Template:In, the enchantment name and level are displayed in gray (Template:Color).

In Minecraft:Survival and Minecraft:Adventure mode, additional lines are shown for the Minecraft:experience and lapis lazuli requirements:

When the enchantment is not available and there is not enough lapis lazuli in the enchanting table slot, it displays the required lapis lazuli (in red, Template:Color), and consumed experience levels (in gray, Template:Color in Java Edition or Template:Color in Bedrock Edition).
When the enchantment is available, it displays the required lapis lazuli and consumed experience levels both in gray.
When there is enough lapis lazuli, but the player does not meet the level requirement, it displays the enchantment's level requirement in red.

Tooltip when there is not enough lapis lazuli in the enchanting table

Tooltip when there is not enough lapis lazuli in the enchanting table
Tooltip when the player does not meet the level requirement

Tooltip when the player does not meet the level requirement
Tooltip when the enchantment is available

Tooltip when the enchantment is available

Smithing table slots

File:Smithing table tooltip.png

A smithing table tooltip

In a smithing table, the three slots can show tooltips when empty:

Add Smithing Template: always displayed in the first slot.
Add a piece of armor: displayed in the second slot when an armor trim is in the first.
Add Diamond armor, weapon, or tool: displayed in the second slot when a netherite upgrade is in the first.
Add ingot or crystal: displayed in the third slot when an armor trim is in the first.
Add Netherite Ingot: displayed in the third slot when a netherite upgrade is in the first.

Additionally, when items are placed in smithing table slots, their tooltips have fixed width.

Tooltips are not shown in empty smithing table slots on touch controls.

Villager trading

File:Trading tooltip.png

Villager trading tooltip

A tooltip reading "Not enough <Item>" is shown in the villager trading slots when the player added too few items in the slot for trading.

Creative inventory group

Template:Exclusive

File:Category tooltip.png

Creative inventory group tooltip

Item groups in the Minecraft:Creative inventory show their name in a tooltip.

Effect tooltips

Template:Exclusive

File:EffectCompact.png

An effect tooltip

When effects in the Minecraft:inventory are displayed in the compact style, hovering over an effect icon displays more information about that effect.

Option tooltips

Template:IN, when certain buttons, text fields, and sliders are hovered over, or focused on when navigating with Template:Key, they show a description in the form of a tooltip. The “Key Binds” options menu also has tooltips to provide details on conflicts between keys.

Template:IN, most options have descriptions that are always visible instead of tooltips. Menu tooltips are only used in the game menu for the small buttons on the bottom, and a message with the tooltip texture appears in the Minecraft:chat if there are unread messages below.