Minecraft:Tooltip

A tooltip is extra information that appears when hovering over or focusing on certain elements in the user interfaces, or when switching the held Minecraft:item.

Types of tooltips

Item tooltips

File:ExampleTooltip.png

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

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

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:Work in progress 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
5	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	Additional information about map scaling and 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
13	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
14	Projectile's tooltip lines Template:Note [...]
15	Flight duration	Shown when item has `flight_duration` tag in `minecraft:fireworks` component.	Template:Tc
15	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 [...]	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
21	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

Held item tooltips

When switching the item being held, the name of the item appears above the hotbar. Template:IN, held item tooltips also show enchantments and shulker box contents. Template:IN, the “Notification Time” option affects how long this type of tooltip appears on-screen.

Effect tooltips

Template:Exclusive

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

Template:Exclusive

File:OptionTooltip.png

An option tooltip.

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.