Item Tags

Applying Tags
Testing for Tags
List of Vanilla Tags

Item tags can be used to ensure that an item meets certain conditions.

Applying Tags

BP/items/example_item.json

json

{
    "format_version": "1.21.120",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:example_item"
        },
        "components": {
            "minecraft:tags": {
                "tags": ["wiki:example_tag"]
            }
        }
    }
}

Testing for Tags

From Entities

q.equipped_item_all_tags(slot, index?, ...tags)
- Returns whether the item at the specified location has all of the listed tags.
q.equipped_item_any_tag(slot, index?, ...tags)
- Returns whether the item at the specified location has at least one of the listed tags.

minecraft:client_entity > description

json

"scripts": {
    "pre_animation": [
        "v.is_holding_pickaxe = q.equipped_item_all_tags('slot.weapon.mainhand', 'minecraft:is_tool', 'minecraft:is_pickaxe');",
        "v.last_slot_has_food = q.equipped_item_any_tag('slot.hotbar', 8, 'minecraft:is_food');"
    ]
}

From Item Descriptors

q.all_tags(...tags)
- Returns whether the item has all of the listed tags.
q.any_tag(...tags)
- Returns whether the item has at least one of the listed tags.

Item Descriptor

json

{
    "tags": "q.all_tags('minecraft:is_tool', 'minecraft:is_pickaxe') && q.any_tag('minecraft:diamond_tier', 'minecraft:netherite_tier')"
}

From Recipes

minecraft:recipe_shapeless

json

"ingredients": [
    {
        "item": { "tag": "minecraft:planks" }
    }
]

List of Vanilla Tags

Tag	Vanilla Usage	Functionality
`minecraft:arrow`	`minecraft:arrow`
`minecraft:banner`	`minecraft:banner`
`minecraft:boat`	`minecraft:acacia_boat` `minecraft:acacia_chest_boat` `minecraft:bamboo_chest_raft` `minecraft:bamboo_raft` `minecraft:birch_boat` `minecraft:birch_chest_boat` `minecraft:cherry_boat` `minecraft:cherry_chest_boat` `minecraft:dark_oak_boat` `minecraft:dark_oak_chest_boat`
`minecraft:boats`	`minecraft:acacia_boat` `minecraft:acacia_chest_boat` `minecraft:bamboo_chest_raft` `minecraft:bamboo_raft` `minecraft:birch_boat` `minecraft:birch_chest_boat` `minecraft:cherry_boat` `minecraft:cherry_chest_boat` `minecraft:dark_oak_boat` `minecraft:dark_oak_chest_boat`
`minecraft:bookshelf_books`	`minecraft:book` `minecraft:enchanted_book` `minecraft:writable_book`	Items that can be stored in a Chiseled Bookshelf.
`minecraft:chainmail_tier`	`minecraft:chainmail_boots` `minecraft:chainmail_chestplate` `minecraft:chainmail_helmet` `minecraft:chainmail_leggings`
`minecraft:coals`	`minecraft:charcoal` `minecraft:coal`
`minecraft:copper_tier`	`minecraft:copper_axe` `minecraft:copper_boots` `minecraft:copper_chestplate` `minecraft:copper_helmet` `minecraft:copper_hoe` `minecraft:copper_leggings` `minecraft:copper_pickaxe` `minecraft:copper_shovel` `minecraft:copper_spear` `minecraft:copper_sword`
`minecraft:crimson_stems`	`minecraft:crimson_hyphae` `minecraft:crimson_stem` `minecraft:stripped_crimson_hyphae` `minecraft:stripped_crimson_stem`
`minecraft:decorated_pot_sherds`	`minecraft:angler_pottery_sherd` `minecraft:archer_pottery_sherd` `minecraft:arms_up_pottery_sherd` `minecraft:blade_pottery_sherd` `minecraft:brewer_pottery_sherd` `minecraft:brick` `minecraft:burn_pottery_sherd` `minecraft:danger_pottery_sherd` `minecraft:explorer_pottery_sherd` `minecraft:flow_pottery_sherd`	Items that can be used to craft a Decorated Pot. Learn how to create custom pottery sherds here.
`minecraft:diamond_tier`	`minecraft:diamond_axe` `minecraft:diamond_boots` `minecraft:diamond_chestplate` `minecraft:diamond_helmet` `minecraft:diamond_hoe` `minecraft:diamond_leggings` `minecraft:diamond_pickaxe` `minecraft:diamond_shovel` `minecraft:diamond_spear` `minecraft:diamond_sword`
`minecraft:digger`	`minecraft:copper_axe` `minecraft:copper_hoe` `minecraft:copper_pickaxe` `minecraft:copper_shovel` `minecraft:diamond_axe` `minecraft:diamond_hoe` `minecraft:diamond_pickaxe` `minecraft:diamond_shovel` `minecraft:golden_axe` `minecraft:golden_hoe`
`minecraft:door`	`minecraft:acacia_door` `minecraft:bamboo_door` `minecraft:birch_door` `minecraft:cherry_door` `minecraft:copper_door` `minecraft:crimson_door` `minecraft:dark_oak_door` `minecraft:exposed_copper_door` `minecraft:iron_door` `minecraft:jungle_door`
`minecraft:egg`	`minecraft:blue_egg` `minecraft:brown_egg` `minecraft:egg`
`minecraft:golden_tier`	`minecraft:golden_axe` `minecraft:golden_boots` `minecraft:golden_chestplate` `minecraft:golden_helmet` `minecraft:golden_hoe` `minecraft:golden_leggings` `minecraft:golden_pickaxe` `minecraft:golden_shovel` `minecraft:golden_spear` `minecraft:golden_sword`
`minecraft:hanging_actor`	`minecraft:painting`
`minecraft:hanging_sign`	`minecraft:acacia_hanging_sign` `minecraft:bamboo_hanging_sign` `minecraft:birch_hanging_sign` `minecraft:cherry_hanging_sign` `minecraft:crimson_hanging_sign` `minecraft:dark_oak_hanging_sign` `minecraft:jungle_hanging_sign` `minecraft:mangrove_hanging_sign` `minecraft:oak_hanging_sign` `minecraft:pale_oak_hanging_sign`
`minecraft:harness`	`minecraft:black_harness` `minecraft:blue_harness` `minecraft:brown_harness` `minecraft:cyan_harness` `minecraft:gray_harness` `minecraft:green_harness` `minecraft:light_blue_harness` `minecraft:light_gray_harness` `minecraft:lime_harness` `minecraft:magenta_harness`
`minecraft:horse_armor`	`minecraft:copper_horse_armor` `minecraft:diamond_horse_armor` `minecraft:golden_horse_armor` `minecraft:iron_horse_armor` `minecraft:leather_horse_armor` `minecraft:netherite_horse_armor`
`minecraft:iron_tier`	`minecraft:iron_axe` `minecraft:iron_boots` `minecraft:iron_chestplate` `minecraft:iron_helmet` `minecraft:iron_hoe` `minecraft:iron_leggings` `minecraft:iron_pickaxe` `minecraft:iron_shovel` `minecraft:iron_spear` `minecraft:iron_sword`
`minecraft:is_armor`	`minecraft:chainmail_boots` `minecraft:chainmail_chestplate` `minecraft:chainmail_helmet` `minecraft:chainmail_leggings` `minecraft:copper_boots` `minecraft:copper_chestplate` `minecraft:copper_helmet` `minecraft:copper_leggings` `minecraft:diamond_boots` `minecraft:diamond_chestplate`
`minecraft:is_axe`	`minecraft:copper_axe` `minecraft:diamond_axe` `minecraft:golden_axe` `minecraft:iron_axe` `minecraft:netherite_axe` `minecraft:stone_axe` `minecraft:wooden_axe`	Allows the item to be used to strip logs.
`minecraft:is_cooked`	`minecraft:cooked_beef` `minecraft:cooked_chicken` `minecraft:cooked_cod` `minecraft:cooked_mutton` `minecraft:cooked_porkchop` `minecraft:cooked_rabbit` `minecraft:cooked_salmon` `minecraft:rabbit_stew`
`minecraft:is_fish`	`minecraft:cod` `minecraft:cooked_cod` `minecraft:cooked_salmon` `minecraft:pufferfish` `minecraft:salmon` `minecraft:tropical_fish`
`minecraft:is_food`	`minecraft:apple` `minecraft:baked_potato` `minecraft:beef` `minecraft:beetroot` `minecraft:beetroot_soup` `minecraft:bread` `minecraft:carrot` `minecraft:chicken` `minecraft:chorus_fruit` `minecraft:cod`	Allows the item to be picked up by foxes.
`minecraft:is_hoe`	`minecraft:copper_hoe` `minecraft:diamond_hoe` `minecraft:golden_hoe` `minecraft:iron_hoe` `minecraft:netherite_hoe` `minecraft:stone_hoe` `minecraft:wooden_hoe`
`minecraft:is_meat`	`minecraft:beef` `minecraft:chicken` `minecraft:cooked_beef` `minecraft:cooked_chicken` `minecraft:cooked_mutton` `minecraft:cooked_porkchop` `minecraft:cooked_rabbit` `minecraft:mutton` `minecraft:porkchop` `minecraft:rabbit`
`minecraft:is_minecart`	`minecraft:chest_minecart` `minecraft:command_block_minecart` `minecraft:hopper_minecart` `minecraft:minecart` `minecraft:tnt_minecart`
`minecraft:is_pickaxe`	`minecraft:copper_pickaxe` `minecraft:diamond_pickaxe` `minecraft:golden_pickaxe` `minecraft:iron_pickaxe` `minecraft:netherite_pickaxe` `minecraft:stone_pickaxe` `minecraft:wooden_pickaxe`
`minecraft:is_shears`	`minecraft:shears`
`minecraft:is_shovel`	`minecraft:copper_shovel` `minecraft:diamond_shovel` `minecraft:golden_shovel` `minecraft:iron_shovel` `minecraft:netherite_shovel` `minecraft:stone_shovel` `minecraft:wooden_shovel`	Allows the item to be used to create dirt paths, extinguish campfires and turn layers of snow into snowballs.
`minecraft:is_spear`	`minecraft:copper_spear` `minecraft:diamond_spear` `minecraft:golden_spear` `minecraft:iron_spear` `minecraft:netherite_spear` `minecraft:stone_spear` `minecraft:wooden_spear`
`minecraft:is_sword`	`minecraft:copper_sword` `minecraft:diamond_sword` `minecraft:golden_sword` `minecraft:iron_sword` `minecraft:mace` `minecraft:netherite_sword` `minecraft:stone_sword` `minecraft:wooden_sword`
`minecraft:is_tool`	`minecraft:copper_axe` `minecraft:copper_hoe` `minecraft:copper_pickaxe` `minecraft:copper_shovel` `minecraft:copper_sword` `minecraft:diamond_axe` `minecraft:diamond_hoe` `minecraft:diamond_pickaxe` `minecraft:diamond_shovel` `minecraft:diamond_sword`
`minecraft:is_trident`	`minecraft:trident`
`minecraft:leather_tier`	`minecraft:leather_boots` `minecraft:leather_chestplate` `minecraft:leather_helmet` `minecraft:leather_leggings`
`minecraft:lectern_books`	`minecraft:writable_book`
`minecraft:logs`	`minecraft:acacia_log` `minecraft:acacia_wood` `minecraft:birch_log` `minecraft:birch_wood` `minecraft:cherry_log` `minecraft:cherry_wood` `minecraft:crimson_hyphae` `minecraft:crimson_stem` `minecraft:dark_oak_log` `minecraft:dark_oak_wood`	Items that can be used as logs when crafting blocks such as campfires and the Smoker.
`minecraft:logs_that_burn`	`minecraft:acacia_log` `minecraft:acacia_wood` `minecraft:birch_log` `minecraft:birch_wood` `minecraft:cherry_log` `minecraft:cherry_wood` `minecraft:dark_oak_log` `minecraft:dark_oak_wood` `minecraft:jungle_log` `minecraft:jungle_wood`	Items that can be smelted in a furnace to create Charcoal.
`minecraft:mangrove_logs`	`minecraft:mangrove_log` `minecraft:mangrove_wood` `minecraft:stripped_mangrove_log` `minecraft:stripped_mangrove_wood`
`minecraft:music_disc`	`minecraft:music_disc_11` `minecraft:music_disc_13` `minecraft:music_disc_5` `minecraft:music_disc_blocks` `minecraft:music_disc_cat` `minecraft:music_disc_chirp` `minecraft:music_disc_creator` `minecraft:music_disc_creator_music_box` `minecraft:music_disc_far` `minecraft:music_disc_lava_chicken`
`minecraft:nautilus_armor`	`minecraft:copper_nautilus_armor` `minecraft:diamond_nautilus_armor` `minecraft:golden_nautilus_armor` `minecraft:iron_nautilus_armor` `minecraft:netherite_nautilus_armor`
`minecraft:netherite_tier`	`minecraft:netherite_axe` `minecraft:netherite_boots` `minecraft:netherite_chestplate` `minecraft:netherite_helmet` `minecraft:netherite_hoe` `minecraft:netherite_horse_armor` `minecraft:netherite_leggings` `minecraft:netherite_nautilus_armor` `minecraft:netherite_pickaxe` `minecraft:netherite_shovel`
`minecraft:planks`	`minecraft:acacia_planks` `minecraft:bamboo_planks` `minecraft:birch_planks` `minecraft:cherry_planks` `minecraft:crimson_planks` `minecraft:dark_oak_planks` `minecraft:jungle_planks` `minecraft:mangrove_planks` `minecraft:oak_planks` `minecraft:pale_oak_planks`	Allows the item to be used as planks in crafting recipes.
`minecraft:sand`	`minecraft:red_sand` `minecraft:sand`
`minecraft:sign`	`minecraft:acacia_hanging_sign` `minecraft:acacia_sign` `minecraft:bamboo_hanging_sign` `minecraft:bamboo_sign` `minecraft:birch_hanging_sign` `minecraft:birch_sign` `minecraft:cherry_hanging_sign` `minecraft:cherry_sign` `minecraft:crimson_hanging_sign` `minecraft:crimson_sign`
`minecraft:soul_fire_base_blocks`	`minecraft:soul_sand` `minecraft:soul_soil`	Items that can be used like soul sand/soil when crafting blocks such as the Soul Campfire and Soul Torch.
`minecraft:spawn_egg`	`minecraft:allay_spawn_egg` `minecraft:armadillo_spawn_egg` `minecraft:axolotl_spawn_egg` `minecraft:bat_spawn_egg` `minecraft:bee_spawn_egg` `minecraft:blaze_spawn_egg` `minecraft:bogged_spawn_egg` `minecraft:breeze_spawn_egg` `minecraft:camel_husk_spawn_egg` `minecraft:camel_spawn_egg`
`minecraft:stone_bricks`	`minecraft:chiseled_stone_bricks` `minecraft:cracked_stone_bricks` `minecraft:mossy_stone_bricks` `minecraft:stone_bricks`
`minecraft:stone_crafting_materials`	`minecraft:blackstone` `minecraft:cobbled_deepslate` `minecraft:cobblestone`	Items that can be used like cobblestone when crafting blocks such as the Furnace and Brewing Stand.
`minecraft:stone_tier`	`minecraft:stone_axe` `minecraft:stone_hoe` `minecraft:stone_pickaxe` `minecraft:stone_shovel` `minecraft:stone_spear` `minecraft:stone_sword`
`minecraft:stone_tool_materials`	`minecraft:blackstone` `minecraft:cobbled_deepslate` `minecraft:cobblestone`	Items that can be used like cobblestone to craft stone tools.
`minecraft:transform_materials`	`minecraft:netherite_ingot`
`minecraft:transform_templates`	`minecraft:netherite_upgrade_smithing_template`
`minecraft:transformable_items`	`minecraft:diamond_axe` `minecraft:diamond_boots` `minecraft:diamond_chestplate` `minecraft:diamond_helmet` `minecraft:diamond_hoe` `minecraft:diamond_horse_armor` `minecraft:diamond_leggings` `minecraft:diamond_nautilus_armor` `minecraft:diamond_pickaxe` `minecraft:diamond_shovel`
`minecraft:trim_materials`	`minecraft:amethyst_shard` `minecraft:copper_ingot` `minecraft:diamond` `minecraft:emerald` `minecraft:gold_ingot` `minecraft:iron_ingot` `minecraft:lapis_lazuli` `minecraft:netherite_ingot` `minecraft:quartz` `minecraft:redstone`
`minecraft:trim_templates`	`minecraft:bolt_armor_trim_smithing_template` `minecraft:coast_armor_trim_smithing_template` `minecraft:dune_armor_trim_smithing_template` `minecraft:eye_armor_trim_smithing_template` `minecraft:flow_armor_trim_smithing_template` `minecraft:host_armor_trim_smithing_template` `minecraft:raiser_armor_trim_smithing_template` `minecraft:rib_armor_trim_smithing_template` `minecraft:sentry_armor_trim_smithing_template` `minecraft:shaper_armor_trim_smithing_template`
`minecraft:trimmable_armors`	`minecraft:chainmail_boots` `minecraft:chainmail_chestplate` `minecraft:chainmail_helmet` `minecraft:chainmail_leggings` `minecraft:copper_boots` `minecraft:copper_chestplate` `minecraft:copper_helmet` `minecraft:copper_leggings` `minecraft:diamond_boots` `minecraft:diamond_chestplate`	Items that can be trimmed in a Smithing Table.
`minecraft:vibration_damper`	`minecraft:black_carpet` `minecraft:black_wool` `minecraft:blue_carpet` `minecraft:blue_wool` `minecraft:brown_carpet` `minecraft:brown_wool` `minecraft:cyan_carpet` `minecraft:cyan_wool` `minecraft:gray_carpet` `minecraft:gray_wool`	Prevents the item from emitting vibrations when dropped onto the ground.
`minecraft:warped_stems`	`minecraft:stripped_warped_hyphae` `minecraft:stripped_warped_stem` `minecraft:warped_hyphae` `minecraft:warped_stem`
`minecraft:wooden_slabs`	`minecraft:acacia_slab` `minecraft:bamboo_slab` `minecraft:birch_slab` `minecraft:cherry_slab` `minecraft:crimson_slab` `minecraft:dark_oak_slab` `minecraft:jungle_slab` `minecraft:mangrove_slab` `minecraft:oak_slab` `minecraft:pale_oak_slab`
`minecraft:wooden_tier`	`minecraft:wooden_axe` `minecraft:wooden_hoe` `minecraft:wooden_pickaxe` `minecraft:wooden_shovel` `minecraft:wooden_spear` `minecraft:wooden_sword`
`minecraft:wool`	`minecraft:black_wool` `minecraft:blue_wool` `minecraft:brown_wool` `minecraft:cyan_wool` `minecraft:gray_wool` `minecraft:green_wool` `minecraft:light_blue_wool` `minecraft:light_gray_wool` `minecraft:lime_wool` `minecraft:magenta_wool`	Allows the item to be used as wool in crafting recipes.