Minecraft:Tooltip

File:ExampleTooltip.png

An example of an item tooltip with enchantments and Minecraft:attributes

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

Types of tooltips

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 Minecraft: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, tooltips in the inventory display the category of the item (Construction, Equipment, Items, or Nature) on the first line below the item name in dark blue when the recipe book or Minecraft:Creative inventory is shown.

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.

Description of item tooltip lines

Template:Dynamic list The table below describes all possible tooltip lines, including these shown when advanced tooltips are enabled. Note that table preserves the order of these lines too.

In "Content" column, cells with yellow background means the exact text displayed. Additionally, cells marked "[...]" means that this field has variable lines count.

All available information displayed on tooltips

Order	Content	Description	Template:Tooltip
0	Item name	The item name. Some data components are able to alter the default item name (note that minecraft:custom_name component has highest priority and overrides any other alterations).	Template:Tc
1	Template:Tc	Graphical representation of the bundle's contents and its fullness bar. Shown only on bundle items. If bundle is empty, the description text will be printed, otherwise bundle contents stored in minecraft:bundle_contents will be shown. This is the only case where information is presented in other form than text.	Template:Tc
	Bundle contents
	Bundle fullness bar
2	Creative inventory section	Section name to which the item belongs. Shown when player is in Creative mode, and only in Search Items, Survival Inventory and Saved Hotbars tabs. Note that in most cases this text will not appear if item has additional data components Template:Verify.	Template:Tc
3	Template:Tc	Description of smithing template, shown only on smithing template items.	Template:Tc
	Template:Tc
	Template:Tc
	Applicable items
	Template:Tc
	Ingredients
4	Painting's name	Painting description, shown when item ID is minecraft:painting and have valid minecraft:painting/variant component.	Template:Tc
	Painting's author
	Painting's dimensions
5	Tropical fish's pattern	The pattern of tropical fish, defined by minecraft:tropical_fish/pattern component.	Template:Tc
	Tropical fish's base and pattern color	The base and pattern colors of tropical fish, defined by minecraft:tropical_fish/base_color and minecraft:tropical_fish/pattern_color components.	Template:Tc
6	Goat horn's instrument	Goat Horn instrument, defined by minecraft:instrument component.	Template:Tc
7	Template:Tc	Shown when item has minecraft:map_id component pointing to a unknown map.	Template:Tc
	Map ID	Shown when item has valid minecraft:map_id component.	Template:Tc
	Template:Tc	This line appears only if map with specified ID is locked. See this article for more information.	Template:Tc
	Map scaling	Additional information about map scaling and level.	Template:Tc
	Map level
8	Number of bees	The number of bees (entities) hiding inside, defined by minecraft:bees component. Displayed naturally on beehives and bee nests.	Template:Tc
9	Template:Tc	Indicates that this item has minecraft:container_loot component.	Template:Tc
10	1st item name + amount	Item names "held" in first five slots of this item, defined by minecraft:container component. When item count is 6 or higher, the line with remaining items will be shown.	Template:Tc
	2nd item name + amount
	3rd item name + amount
	4th item name + amount
	5th item name + amount
	Count of the rest items (not their total amount)
11	1st banner pattern	Six first banner patterns, defined by minecraft:banner_patterns component. Note that banners with more than 6 patterns are uncraftable, and can be obtained only with commands.	Template:Tc
	2nd banner pattern
	3rd banner pattern
	4th banner pattern
	5th banner pattern
	6th banner pattern
12	Template:Tc	Materials used to craft this decorated pot, defined by minecraft:pot_decorations component.	Template:Tc
	Front side material
	Left side material
	Right side material
	Rear side material
13	Book's author	Shown when minecraft:written_book_content component is present. Meant for written books.	Template:Tc
	Book's generation
14	Projectile name	A section describing charged projectile, defined by minecraft:charged_projectiles component. Meant to be used with crossbows. Note that this section may appear multiple times, if the item contains multiple projectiles loaded.	Template:Tc
	Projectile's tooltip lines Template:Note [...]
15	Flight duration	Shown when item has flight_duration tag in minecraft:fireworks component.	Template:Tc
	Firework effects [...]	All firework effects applied with firework stars.	Template:Tc
16	Template:Tc	Shown when item has minecraft:potion_contents component, but is empty.	Template:Tc
	Effect name	A single primary effect to be applied. Shown when item has filled potion tag in minecraft:potion_contents component.	Template:Tc
	Custom effects [...]	List of custom effects to be applied. Shown when item has entries in custom_effects list in minecraft:potion_contents component.	Template:Tc
	Template:Tc	A section describing how item will affect on player's attributes when consumed.	Template:Tc
	Template:Tc
	Attributes [...]
17	Music disc name	Shown when item has minecraft:jukebox_playable component with valid value.	Template:Tc
18	Template:Tc	Armor trim upgrade, defined by minecraft:trim component.	Template:Tc
	Trim pattern
	Trim material
19	Stored enchantments [...]	Minecraft:Enchantments stored in minecraft:stored_enchantments component. Meant to be used for enchanted books.	Template:Tc
20	Applied enchantments [...]	Enchantments applied on this item, stored in minecraft:enchantments component.	Template:Tc
21	Template:Tc	Shown when item has minecraft:dyed_color component.	Template:Tc
	Color	A hexadecimal color code. Replaces text above, if advanced tooltips are enabled.	Template:Tc
22	Lore [...]	Custom text shown in tooltip, defined by minecraft:lore component. By default it has "dark_purple" color and is italicized.	Template:Tc
23	Template:Tc	Attribute modifiers applied when this item is held or equipped, defined in minecraft:attribute_modifiers component. Note that this section may appear multiple times, if the component above contains many modifiers with different slot tags.	Template:Tc
	"When (...)" field Template:Note
	Attributes [...]
24	Template:Tc	Shown when item is unbreakable, using minecraft:unbreakable component.	Template:Tc
25 Template:Note	Template:Tc	Shown when item has minecraft:suspicious_stew_effects component, but is empty.	Template:Tc
	Effects [...]	List of effects passed in minecraft:suspicious_stew_effects list.	Template:Tc
	Template:Tc	A section describing how item will affect on player's attributes when consumed.	Template:Tc
	Template:Tc
	Attributes [...]
26	Honey amount	Shown when item has honey_level tag in minecraft:block_state component. Displayed naturally on beehives and bee nests.	Template:Tc
27	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:Tc
28	Template:Tc	Shown when item ID is minecraft:spawner or minecraft:trial_spawner.	Template:Tc
	Template:Tc
	Template:Tc
	Spawner entity name	Shown when item ID is minecraft:spawner or minecraft:trial_spawner and has SpawnData or spawn_data tag respectively in minecraft:block_entity_data component.	Template:Tc
29	Template:Tc	Shows a list of blocks defined in minecraft:can_break component that can be mined with this item.	Template:Tc
	Template:Tc
	Block names [...]
30	Template:Tc	Shows a list of blocks defined in minecraft:can_place_on component on which this block can be placed.	Template:Tc
	Template:Tc
	Block names [...]
31	Durability	Remaining and total durability of the tool item. Hidden if item contains minecraft:unbreakable component.	Template:Tc
32	Item ID	Internal item ID.	Template:Tc
33	Number of components	Total number of data components.	Template:Tc
34	Template:Tc	Usage warning, shown on block items with id tag in minecraft:block_entity_data component. This is the only section that cannot be hidden using minecraft:tooltip_display component.	Template:Tc
	Template:Tc
	Template:Tc

Effect tooltips

File:EffectCompact.png

An effect tooltip.

When Minecraft: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

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

References

<references />