Minecraft:Tooltip

File:ExampleTooltip.png

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.

Description of item tooltip lines

Template:Dynamic listThe 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.

#	Content	Description	Minecraft:Color codeTemplate:Info needed
0	Item name	The name of the item. Custom item names, for example when renamed in an anvil, are italic (§o), and can have formatting codes.Template:Only Certain items have variable names, such as Minecraft:buckets of tropical fishTemplate:Only and filled maps. Shown on the HUD above the hotbar when selecting the item.	Depends on Minecraft:rarity: Common: §f (Template:Color) Uncommon: §e (Template:Color) Rare: §b (Template:Color) Epic: §d (Template:Color)
1	Template:Tc	Shown on Minecraft:bundles when empty.	§8 (Template:Color)
	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.	-
	Bundle fulness bar	A progress bar that can display "Empty", a blue progress, or "Full" with red progress.
2	Item descriptionTemplate:Only	Many items have a description about their functionality:Template:Collapse	§9 (Template:Color)
	Redstone functionalityTemplate:Only	Items with functionality in Minecraft:redstone circuits can display additional information below the description:Template:Collapse	§c (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.
3Template:Only	Template:Tc	Description of smithing templates, shown only on smithing template items.
	Template:Note
	Template:Tc
	Applicable items
	Template:Tc
	Ingredients
3Template:Only	Template:Tc	Always shown on Minecraft:smithing templates.	§7 (Template:Color)
	Template:Tc	Shown on all armor trims.	§9 (Template:Color)
	Template:Tc	Shown on netherite upgrades.
4Template: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
5	Template:Tc	Shown on the disc fragment item.	§7 (Template:Color)
6Template: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.
	Tropical fish's base and pattern color
7	Goat horn instrument	The instrument of the goat horn, e.g. "Ponder".	§7 (Template:Color)
8	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.	§f (Template:Color)
	Template:Tc	Shown when the map is locked.
	Map scalingTemplate:Only	Additional information about map scaling and level. Only shown with advanced tooltips enabled.
	Map levelTemplate:Only
9Template:Only	Number of bees	Number of Minecraft:bee entities inside the Minecraft:beehive or bee nest.
10Template:Only	Template:Tc	Indicates that this item has the minecraft:container_loot component.Template:Info needed
11	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.	§7 (Template:Color)
12	Banner patterns	Displays all (max 6) Minecraft:banner patterns preceded by their color.	§f (Template:Color)
13	Template:Tc	Decorated pot materials, either a pottery sherd item name or "Minecraft:Brick".
	Front side material		§7 (Template:Color)
	Left side material
	Right side material
	Rear side material
14	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.
	Book's generation	The book's generation, which can be "Original", "Copy of original", or "Copy of a copy".
15Template:Only	Projectile name	Shown on Minecraft:crossbows with a charged projectile.
	Projectile's tooltip linesTemplate:Note
16	Flight duration	A firework rocket's flight duration, e.g. "Flight Duration: 3".	§9 (Template:Color)
	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, Large Ball, Burst, Star-shaped, or Creeper-shaped) All colors (e.g. Black, Light Blue, Gray, Gray, Lime, Pink) Trail, if applied Twinkle, if applied
17	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 §7 (Template:Color).
	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 §7 (Template:Color).	When positive: §9 (Template:Color) When negative: §c (Template:Color)
	Template:Tc	Attribute information, e.g. "+2.99 Attack Damage". Can only show Speed and Attack Damage.
	Template:Tc
	Attributes
18	Music disc name	The name of the music disc, e.g. "C418 - strad".	§7 (Template:Color)
	Template:Tc	Shown when the music disc is queued next in a Minecraft:jukebox playlist.	§a (Template:Color)
19Template:Only	Upgrade:	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
19Template:Only	Trim pattern & material		Depends on used materials: Quartz: §h (Template:Color) Iron: §i (Template:Color) Netherite: §j (Template:Color) Redstone: §m (Template:Color) Copper: §n (Template:Color) Gold: §p (Template:Color) Emerald: §q (Template:Color) Diamond: §s (Template:Color) Lapis: §t (Template:Color) Amethyst: §u (Template:Color) Resin: §v (Template:Color)
20/21	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: §9 (Template:Color) Curses: §c (Template:Color)
22	Template:Tc	Shown when the item (leather armor or wolf armor) is dyed. In Bedrock Edition, shown below attributes (24).	§f (Template:Color)
	Template:Tc
	ColorTemplate:Only	The hexadecimal color of the dye, shown only when advanced tooltips is enabled.
23Template:Only	Lore	Custom text shown in tooltip, defined by minecraft:lore component. By default it has "dark_purple" color and is italicized.
24	Template:Tc	The "When..." field specifying the required equipment slot for the attributes to apply.
	Required slotTemplate:Only
	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.	§9 (Template:Color)
25Template:Only	Template:Tc	Shown when item is unbreakable, using the minecraft:unbreakable component.
26Template:Only	Suspicious stew effects	Exactly the same as the potion effects in 17, but for suspicious stew. This is only visible in the Creative mode item selection and not in the inventory or hotbar.
27Template:Only	Honey amount	Amount of honey in Minecraft:beehives or Minecraft:bee nests.
28Template: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.
29Template:Only	Template:Tc	Shown on Minecraft:monster spawners and Minecraft:trial spawners and has spawn data.
	Template:Tc
	Template:Tc
	Spawner entity name
30	Template:Tc	Shows a list of blocks defined in minecraft:can_breakTemplate:Only/can_place_onTemplate:Only component that can be mined with this item in Minecraft:Adventure mode.	§f (Template:Color)
	Template:Tc
	Breakable blocks
31	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
32Template:Only	Durability	Remaining and total Minecraft:durability of the tool item, only shown with advanced tooltips enabled.
33Template:Only	Item ID	Internal item ID, only shown with advanced tooltips enabled.
34Template:Only	Number of components	Total number of data components, only shown with advanced tooltips enabled.
35Template:Only	Template:Tc	Usage warning, shown on block items with id tag in minecraft:block_entity_data component.
	Template:Tc
	Template:Tc
36Template:Only	Template:Tc	Shown on items with lock_in_inventory NBT component. Also shown above the hotbar in Bedrock Edition, in §f (Template:Color) (star) and §7 (Template:Color).	§f (Template:Color)
	Template:Tc
	Template:Tc
	Template:Tc
37Template:Only	Template:Tc	Shown on items with lock_in_slot NBT component. Also shown above the hotbar in Bedrock Edition, in §f (Template:Color) (star) and §7 (Template:Color).
	Template:Tc
	Template:Tc
	Template:Tc
	Template:Tc
38Template:Only	Template:Tc	Shown on items with keep_on_death NBT component. Also shown above the hotbar in Bedrock Edition, in §7 (Template:Color).
39Template:Only	Template:Tc	Shown on items obtained using Template:KeysTemplate:Control, making them contain data (such as a command block with commands).	§o (italics) and §5 (Template:Color)

Other tooltips

Enchanting table options

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. It is italicized, and formatted like "<Enchantment> <level> . . . ?"

Smithing table slots

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

• 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.

Effect tooltips

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

File:OptionTooltip.png

An option tooltip

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.

History

Java Edition

Template:HistoryTable

Legacy Console Edition

• The old Java Edition item tooltip as seen in the Minecraft:statistics menu before 1.20.2
  The old Java Edition item tooltip as seen in the Minecraft:statistics menu before 1.20.2

Gallery

Examples

• An example of a Minecraft:smithing template tooltip
  An example of a Minecraft:smithing template tooltip
• An example of a tooltip for a trimmed piece of Minecraft:armor
  An example of a tooltip for a trimmed piece of Minecraft:armor
• An example of a Minecraft:painting tooltip in the Creative inventory Template:In
  An example of a Minecraft:painting tooltip in the Creative inventory Template:In
• An example of a Minecraft:goat horn tooltip
  An example of a Minecraft:goat horn tooltip
• An example of a Minecraft:written book tooltip
  An example of a Minecraft:written book tooltip
• Tooltip in the game menu
  Tooltip in the game menu
• An example of a Minecraft:crossbow tooltip
  An example of a Minecraft:crossbow tooltip
• An example of a Minecraft:decorated pot tooltip
  An example of a Minecraft:decorated pot tooltip
• An example of a Minecraft:bucket of tropical fish tooltip Template:In
  An example of a Minecraft:bucket of tropical fish tooltip Template:In
• An example of a key bind conflict tooltip Template:In
  An example of a key bind conflict tooltip Template:In