Data tags

Data tags are pieces of information that get stored on items and blocks. Tags are used to alter items in various ways, such as in appearance or in functionality.

Usage

Data tags can be applied to items by using the give command. They are the fourth parameter.

An example of a give command using data tags:

Item tags example

This command gives the player a purple Leather Cap named "Purple Hat" that has the two enchantments "Unbreaking II" and "Fire Protection III":

give leather_cap 1 0 {type:"purple", name:"Purple Hat", enchantments:["unbreaking2", "Fire Protection III"]}

Block tags example

This command replaces a block near the player with a chest named "Lemon Chest" full of iron pickaxes with only one use left:

setblock chest ~1 ~-1 replace {name:"Lemon Chest", items:{id:"iron_pickaxe", damage:-1}}

Mob tags and loot tags example

This command spawns a pig spawnskin named "Fake Pig" that has 10 health and drops 1-3 "Fake" porkchops:

summon spawnskin 1 ~ ~ {skin:15868, name:"Fake Pig", health:10, drops:[{item:{id:"porkchop", name:"Fake Pork"}, quantity:1, bonus:2}]}

This command spawns a skin named "Red" that wears a diamond helmet and will attack the player back if hit:

summon spawnskin 1 ~ ~ {skin:67524, aggro:"neutral", armor:["diamond_helmet", {}, {}, {}], name:"Red"}

Tags

Item Tags

Listed below are all the data tags that can be applied to items.

Tag Name	Description	Values and Applicable Items
type	Specifies the type of the item. Oftentimes this is the color of the item, such as wool. If the value is invalid for the item, the value will be omitted.	String spawn_egg: The mob spawned by the egg ("zombie", "ender dragon", "nethereye") potion: Specifies the type of potion ("empty", "water", "fire protection +") dye, glass, glass_backdrop, leather_boots, leather_pants, leather_tunic, leather_cap: Color ("red", "purple", "light gray") carpet, wool, wool_backdrop: Color, or "rainbow" balloon: Color, or "ghast"
unbreakable	If enabled, and the item is a tool, the item will never lose durability.	Boolean Applies to all tools. Value is simply omitted when false.
enchantments	A list of enchantments applied to the item.	Array of Strings Applies to all items. Both "unbreaking1" and "Unbreaking I" will refer to the same enchantment. Duplicate enchantments are ignored. See enchanting for a list of enchantment identifiers.
anvilUses	Specifies the number of times the item has been used in an anvil. This only affects the cost of using an anvil on the item.	Integer Applies to all items.
name	Overrides the default naming of the item (as if it was renamed by an anvil).	String Applies to all items.
canDestroy	Specifies the id of the block the item can destroy in Adventure mode.	String or Array of Strings Applies to any item. The specified IDs must be that of blocks. The special string all inverts the mask.
canPlaceOn	Specifies the id of the block which the item can be placed in Adventure mode.	String or Array of Strings Only applies blocks. The specified IDs must be that of blocks. The special string all inverts the mask.
showParticles	When disabled, this will hide the particles of potion effects when a potion is drank.	Boolean Only applies to potion. Value is simply omitted when true.
category	Specifies the category of certain items.	String Only applies to potion. Potions with the "splash" category are splash potions.
command	Specifies the command run by a command book.	String Only applies to command_book. Command will not be checked for errors upon creation.
uses	Specifies how many times a command book can be used before it disappears.	Integer Only applies to command_book. Negative numbers are invalid.

Block Tags

Listed below are all the data tags that can be applied to blocks.

Tag Name	Description	Values and Applicable Blocks
type	Specifies the type of the block. Oftentimes this is the color of the block, such as wool. If the value is invalid for the item, the value will be omitted.	String dye, glass, glass_backdrop: Color ("red", "purple", "light gray") carpet, wool, wool_backdrop: Color, or "rainbow" mob_head: Creeper, zombie, skeleton, enderdragon, or skin ID
name	Specifies the display name of a container block (such as a chest), as if it was renamed by an anvil.	String Applies to chest, furnace, brewing_stand, enchantment_table, dropper, dispenser.
growth	Specifies the growth stage of a crop.	Integer Applies to melon_seed, pumpkin_seed, seeds, carrot, potato, nether_wart, beetroot_seeds. Value clamped to range 1-7.
text	Defines the writing on a sign.	String Applies only to sign.
damage	Specifies the damage state of an anvil.	Integer Applies only to anvil. Value clamped to range 1-3.
items	Defines the items inside of the container.	Item Data or Array of Item Data chest is an array of 27 item data. dropper and dispenser are an array of 9 item data. If the value is an item data without an array, the item will be duplicated for each item slot.
input	Defines the input item of a block.	Item Data furnace accepts any item that can be smelted. brewing_stand accepts any brewing ingredient. If the value is an item data without an array, the item will be duplicated for each item slot.
fuel	Defines the fuel item of a block.	Item Data furnace accepts any fuel. brewing_stand only accepts blaze powder.
output	Defines the output item(s) of a block.	Item Data or Array of Item Data (for brewing_stand) furnace accepts any item. brewing_stand accepts potions. If the value is an item data without an array, the item will be duplicated for each item slot.
activated	Defines whether a block is activated.	Boolean Only applies to the switch state of a lever
facing	Determines the orientation of a block.	String coral_lantern, torch, odd_rock_torch, redstone_torch, button, lever: "left", "right", or "up". piston, piston_sticky, hay, wood: "left", "right", "up", or "down". Any _stair block: "left", "right", "upleft", "upright", "downleft", or "downright". Any _slab block: "up", or "down". mob_head: "left" or "right".

Mob Tags

Listed below are all the mob tags that can be applied to mobs.

Tag Name	Description	Values and Applicable Mobs
name	Specifies the name of the mob, as though applied via a name tag.	String Applies to all mobs.
health	Specifies the current health of the mob.	Integer Applies to all mobs. The minimum value is 1, however the value is not capped at the maximum health for the spawned mob type. When a mob's health is above the maximum, healing the mob will be ineffectual. The max health of a mob cannot be changed.
holding	Specifies the item in the mob's hand slot.	Item Data or String Applies only to endermen and zombie pigmen. If String is specified in place of the item data, a single item matching the value's identifier will be given to the mob.
armor	Specifies the items in the mob's armor slots.	Array of Item Data or String, length 4 Applies only to zombies and spawnskins. If String is specified in place of the item data in the array, a single item matching the value's identifier will be given to the mob. An empty {} item data object can also be specified, and must be specified if any of the slots is to be empty. The elements of the array correspond to the helmet slot, chestplate slot, leggings slot, and boots slot respectively from first to last.
defaultDrops	Specifies whether or not the mob will drop their default items upon death. Often used in combination with drops for overriding the drops of a mob.	Boolean Applies to all mobs.
drops	Specifies the loot the mob will drop upon death.	Array of Loot Data Applies to all mobs. See Loot Tags for more details. Often used in combination with defaultDrops:false for overriding the drops of a mob.
skin	Specifies the skin ID for spawnskin mobs.	Integer Applies only to spawnskin.
aggro	Specifies the hostility of spawnskin mobs.	String Applies only to spawnskin. The valid values are: "hostile" to create a spawnskin that is aggravated at the player on sight, "neutral" to create a spawnskin that is aggravated when hit, and "passive" (the default) to create a spawnskin that cannot deal attack damage.
charged	Determines whether or not a creeper is charged.	Boolean Applies only to creeper.
baby	Specifies if the mob is spawned as a baby.	Boolean Applies to chicken, sheep, rabbit, pig, wolf, cow, mooshroom, and cowctus.

Loot Tags

Listed below are all the tags that are used in loot tables.

Tag Name	Description	Values and Applicable Situations
item	This is the item that is produced if the conditions are right for the item to be dropped.	Item Data or String Must be in all loot tags.
quantity	The minimum number of times the item drops (if the conditions are met). Defaults to 1.	Integer
bonus	A random number of extra items can be dropped up to the specified value (if the conditions are met). Defaults to 0. The calculation of extra items is as expected: floor(random()*(bonus + 1))	Integer
lootBonus	A random number of extra items can be dropped at max looting enchantment (if the conditions are met) up to the specified value. Defaults to 0. The calculation of extra items is as follows: floor((random()*.6 + .4)*lootLevel/3*(lootBonus + 1))	Integer
chance	A success condition This adds a random chance that the loot will drop. If the condition is not met, the loot will not be dropped. The procedure is as follows: Generate a random number for the given seed if it doesn't already exists Calculate chance: random(seed)*(1 - lootOffset*lootLevel/3) Succeed condition if chance >= min and chance < max Using the same seed can allow a loot table to drop one item or another one, but never both.	Object The chance object is as follows (with default values): {seed:0, min:0, max:1, lootOffset:0} seed determines which random number to use. min determines the lower bound to succeed the check. max determines the upper bound to succeed the check. lootOffset reduces the range of the random number per level of looting
variant	A success condition Only drops the item if the mob variant matches the killed mob.	String Only applies to mobs with variants. Accepts "normal", "mooshroom", and "cowctus".
sheared	A success condition Only drops the item if the mob is or is not sheared, depending on the value.	Boolean Applies to the sheep mob.
isBaby	A success condition Only drops the item if the mob is or is not a baby, depending on the value.	Boolean Applies to all mobs.
color	A success condition Only drops the item if the color of the object matches, depending on the value.	Color Only applies to sheep and dog mobs.
onFire	A success condition Only drops the item if object is on fire.	Boolean Applies to all mobs.
size	A success condition Only drops the item if a mob's size matches the value.	Integer Only applies to magma_cube and slime.

Color Values

For colored items or blocks, the color is specified using the type data tag.

Type	Preview
red
green
blue
brown
cyan
lightblue
lightgreen
magenta
orange
pink
purple
white
yellow
lightgray
gray
black
rainbow

History

Version	Date	Changes
1.25	May 11, 2013	Added data tags to store item properties
1.28	Oct 08, 2016	Data tags can be specified when using the /give command
1.29	Sep 27, 2019	New item data tags: "canDestroy" and "canPlaceOn" Unbreakable works on armor again Added data tags for blocks, mobs, and mob loot
1.29.1	Oct 05, 2019	Fixed being unable to pick up items matching against blank data tags Loot data tag "chance" now applies to drop table Block data tag "powered" renamed to "activated"
1.29.2	Oct 20, 2019	Added "color" mob data tag for sheep wool and wolf collars "sheared", "size", "color", and "tamed" drop data properties apply properly
1.30	Nov 13, 2020	Added "aggro" mob tag for spawnskins Added "armor" mob tag for spawnskins and zombies The "defaultDrops" mob data tag now works The "type" data tag now parses properly for item data lists

See also

• Commands