Tag

From Minecraft Wiki
Jump to: navigation, search
This article is about data pack tags. For other uses, see Tag (disambiguation).
Information icon.svg
This feature is exclusive to Java Edition.

Tags in data packs allow players to group items, blocks, fluids, entity types or functions together using JSON files.

Usage[edit]

To utilize block, item, or function tags the JSON files must be placed in a data pack inside the data/(namespace)/tags/blocks, data/(namespace)/tags/items, data/(namespace)/tags/entity_types or data/(namespace)/tags/functions folder respectively.

Minecraft itself also uses tags. For example, vanilla block tags are used for various block properties, vanilla item tags are used for various item properties, vanilla advancement files and vanilla recipe files, and vanilla entity type tags are used for various mob properties. See #List of tags section for their usages.

There are no vanilla function tags since there are no vanilla functions, but the game reads from certain function tags under the minecraft namespace.

Folder structure[edit]

  • (data pack root directory)
    • data
      • (namespace)
        • tags
          • blocks
            • (name).json
          • entity_types
            • (name).json
          • fluids
            • (name).json
          • functions
            • (name).json
          • items
            • (name).json

Block tags[edit]

Block tags can be called when testing for block arguments in commands with #(namespaced ID), which succeeds if the block matches any of the blocks specified in the tag.

Item tags[edit]

Item tags can be called when testing for item arguments in commands with #(namespaced ID) or in recipes and advancements using "tag": "(namespaced ID)", which succeeds if the item matches any of the items specified in the tag. They can also be searched in the creative inventory by searching #(namespaced ID).

Entity type tags[edit]

Entity type tags can be called in type target selector argument and loot table conditions with #(namespaced ID), which checks if the entity's type matches any of the entity types specified in the tag.

Function tags[edit]

Function tags can be called in the /function command with #(namespaced ID), which runs all the functions specified in the tag in the order of their first appearance in a tag. If a function is referenced multiple times in a tag and its sub-tags, it is run once.

Moreover, functions tagged in the minecraft:tick tag runs every tick at the start of the tick and functions tagged in minecraft:load runs once at the start of the tick after a server (re)load.

JSON format[edit]

  • The root object.
    •  replace: Optional. Whether or not contents of this tag should completely replace tag contents from different lower priority data packs with the same namespaced ID. When false the tag's content is appended to the contents of the higher priority data packs, instead. Defaults to false.
    •  values: A list of mix and match of object names and tag names. For tags, recursive reference is possible, but a circular reference causes a loading failure.
      • : An object's namespaced ID in the form (namespaced ID).
      • : ID of another tag of the same type in the form #(namespaced ID).
      • : An entry with additional options. (1.16.2+)
        •  id: A string in one of the string formats above.
        •  required: Whether or not loading this tag should fail if this entry is not found, true by default (also for the string entries). A tag that fails to load can still be referenced in any data pack and be (re)defined in other data packs. In other words, only the entries in this JSON file is ignored if this entry cannot be found.

List of tags[edit]

Blocks[edit]

Tag name Values Usage
acacia_logs acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood
anvil anvil, chipped_anvil, damaged_anvil
  • Used to determine which blocks should open the anvil GUI. Does not work for any other blocks than the default ones. Removing any of the default blocks may cause the GUI to flash quickly before disappearing.
  • Used to determine the damage source for entities being damaged by a falling block, which is used by the death messages.
  • Used to determine if a block has a chance to get "damaged" or break upon landing.
  • Blocks added receive only their falling block properties when summoned through commands. For example, sand does not harm entities unless summoned.
  • Used in reading NBT from falling block entities to set the internal HurtEntities boolean to true if the entity did not have HurtEntities set.
  • Used to determine if the block should have a chance to take damage from using the anvil GUI.
bamboo_plantable_on bamboo, bamboo_sapling, gravel, #sand, dirt, grass_block, podzol, coarse_dirt, mycelium
  • Used to check where bamboo can be planted
banners white_banner, orange_banner, magenta_banner, light_blue_banner, yellow_banner, lime_banner, pink_banner, gray_banner, light_gray_banner, cyan_banner, purple_banner, blue_banner, brown_banner, green_banner, red_banner, black_banner, white_wall_banner, orange_wall_banner, magenta_wall_banner, light_blue_wall_banner, yellow_wall_banner, lime_wall_banner, pink_wall_banner, gray_wall_banner, light_gray_wall_banner, cyan_wall_banner, purple_wall_banner, blue_wall_banner, brown_wall_banner, green_wall_banner, red_wall_banner, black_wall_banner
  • Used by maps upon clicking a block, to see if it should place a marker. Adding blocks to this animation causes maps to play the use animation when clicked, but no marker is added.
  • Used in the #wall_post_override block tag.
base_stone_nether netherrack, basalt, blackstone
base_stone_overworld stone, granite, diorite, andesite
  • Used to determine what blocks dirt, gravel, granite, diorite, andesite, coal ore, iron ore, gold ore, redstone ore, diamond ore, lapis lazuli ore, and infested stone can replace when generated as underground ores.
beacon_base_blocks netherite_block, emerald_block, diamond_block, gold_block, iron_block
  • Used by beacons to check which base blocks can activate it.
beds red_bed, black_bed, blue_bed, brown_bed, cyan_bed, gray_bed, green_bed, light_blue_bed, light_gray_bed, lime_bed, magenta_bed, orange_bed, pink_bed, purple_bed, white_bed, yellow_bed
  • Cats use this tag to determine where to sit or sleep with the player.
  • Used to determine what blocks can be slept in by villagers.
  • Used to determine what blocks baby villagers can jump on.
  • Adding blocks to this tag has no effect on villagers. Villagers still pathfind to beds not in this tag, but they do not jump or sleep on them.
beehives bee_nest, beehive
  • Determines which blocks can fill with honey when a bee deposits pollen.
  • Blocks in this tag can have honey removed by a dispenser with a glass bottle or shears.
  • Used in the 'husbandry/safely_harvest_honey.json' advancement file.
bee_growables #crops, sweet_berry_bush
  • When bees pollinate these blocks they grow one stage.
  • Removing blocks from this tag has no effect.
birch_logs birch_log, birch_wood, stripped_birch_log, stripped_birch_wood
buttons #wooden_buttons, stone_button, polished_blackstone_button
campfires campfire, soul_campfire
  • Bees, parrots, and turtles view blocks in this tag as dealing fire damage and pathfind accordingly.
  • Campfires use this tag to determine if they are lit or not.
  • Flint and steel and fire charges use this tag to determine if it can light campfires. Adding blocks to this tag has no effect.
  • Splash water bottles set the lit value of blocks in this tag to false.
candle_cakes‌[upcoming: JE 1.17] candle_cake, white_candle_cake, orange_candle_cake, magenta_candle_cake, light_blue_candle_cake, yellow_candle_cake, lime_candle_cake, pink_candle_cake, gray_candle_cake, light_gray_candle_cake, cyan_candle_cake, purple_candle_cake, blue_candle_cake, brown_candle_cake, green_candle_cake, red_candle_cake, black_candle_cake
  • Blocks in this tag are considered candle cakes and can be lit, if they have the lit block state set to false.
candles‌[upcoming: JE 1.17] candle, white_candle, orange_candle, magenta_candle, light_blue_candle, yellow_candle, lime_candle, pink_candle, gray_candle, light_gray_candle, cyan_candle, purple_candle, blue_candle, brown_candle, green_candle, red_candle, black_candle
  • Blocks in this tag are considered candles and can be lit, if they have the lit and watterlogged block state and both are false.
carpets white_carpet, orange_carpet, magenta_carpet, light_blue_carpet, yellow_carpet, lime_carpet, pink_carpet, gray_carpet, light_gray_carpet, cyan_carpet, purple_carpet, blue_carpet, brown_carpet, green_carpet, red_carpet, black_carpet
cauldrons‌[upcoming: JE 1.17] cauldron, water_cauldron, lava_cauldron, powder_snow_cauldron
climbable ladder, vine, scaffolding, weeping_vines, weeping_vines_plant, twisting_vines, twisting_vines_plant
  • Used in mob pathfinding.
  • This tag is used to determine what blocks the player can climb.
  • For the player to be able to climb added blocks, the block must be small enough that the center of the player's hitbox can occupy the same block.
  • This means that blocks such as chests cannot be climbed from the sides, but can from the top.
  • If scaffolding is removed, the player cannot smoothly climb up, but can still jump up and crouch down.
corals #coral_plants, tube_coral_fan, brain_coral_fan, bubble_coral_fan, fire_coral_fan, horn_coral_fan
coral_blocks tube_coral_block, brain_coral_block, bubble_coral_block, fire_coral_block, horn_coral_block
  • Used to generate coral reefs.
  • Using bone meal on a sea pickle on a block in this tag creates more sea pickles.
coral_plants tube_coral, brain_coral, bubble_coral, fire_coral, horn_coral
crimson_stems crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae
  • Used in the #logs block tag.
crops beetroots, carrots, potatoes, wheat, melon_stem, pumpkin_stem
crystal_sound_blocks‌[upcoming: JE 1.17] amethyst_block, budding_amethyst
  • Blocks in this tag play play the "amethyst block chime" sound repeatedly for a short amount of time after being stepped on, gradually decreasing in volume.
  • The initial step sound is not affected by this tag.
dark_oak_logs dark_oak_log, dark_oak_wood, stripped_dark_oak_log, stripped_dark_oak_wood
doors #wooden_doors, iron_door
  • Mobs view all blocks in this tag as doors and pathfind accordingly.
  • [check the code]
dragon_immune barrier, bedrock, end_portal, end_portal_frame, end_gateway, command_block, repeating_command_block, chain_command_block, structure_block, jigsaw, moving_piston, obsidian, crying_obsidian, end_stone, iron_bars, respawn_anchor
  • Used to determine what blocks the ender dragon can't destroy.
enderman_holdable #small_flowers, grass_block, dirt, coarse_dirt, podzol, sand, red_sand, gravel, brown_mushroom, red_mushroom, tnt, cactus, clay, pumpkin, carved_pumpkin, melon, mycelium, crimson_fungus, crimson_nylium, crimson_roots, warped_fungus, warped_nylium, warped_roots
  • Used to determine what blocks endermen can pick up.
fence_gates acacia_fence_gate, birch_fence_gate, dark_oak_fence_gate, jungle_fence_gate, oak_fence_gate, spruce_fence_gate, crimson_fence_gate, warped_fence_gate
fences #wooden_fences, nether_brick_fence
  • Mobs view all blocks in this tag as fences and pathfind accordingly.
  • Leads can be attached to solid blocks in this tag.
  • The lead knot entity uses this tag to determine if it should break or not.
  • Fences in this tag attempt to connect only to other fences in this tag, but not in the #wooden_fences block tag.
  • Fences not in either tag do not connect to fences in the #wooden_fences block tag.
fire fire, soul_fire
  • Blocks in this tag are ignored when detecting valid unactivated nether portals, and get removed upon activation
  • Mobs view all blocks in this tag as fire and pathfind accordingly.
  • Blocks in this tag cannot stop falling blocks.
  • Potions capable of dousing fire remove blocks in this tag.
flowers #small_flowers, #tall_flowers
  • Bees can pollinate and remember blocks in this tag
  • Saplings grown next to blocks in this tag have a chance to have a bee nest
flower_pots flower_pot, potted_poppy, potted_blue_orchid, potted_allium, potted_azure_bluet, potted_red_tulip, potted_orange_tulip, potted_white_tulip, potted_pink_tulip, potted_oxeye_daisy, potted_dandelion, potted_oak_sapling, potted_spruce_sapling, potted_birch_sapling, potted_jungle_sapling, potted_acacia_sapling, potted_dark_oak_sapling, potted_red_mushroom, potted_brown_mushroom, potted_dead_bush, potted_fern, potted_cactus, potted_cornflower, potted_lily_of_the_valley, potted_wither_rose, potted_bamboo, potted_crimson_fungus, potted_warped_fungus, potted_crimson_roots, potted_warped_roots
gold_ores gold_ore, nether_gold_ore
guarded_by_piglins gold_block, barrel, chest, ender_chest, gilded_blackstone, trapped_chest, #shulker_boxes, #gold_ores
  • Piglins become hostile toward a player that destroys a block in this tag.
  • This tag has no effect on which blocks cause piglins to become hostile when opened.
hoglin_repellents warped_fungus, potted_warped_fungus, nether_portal, respawn_anchor
ice ice, packed_ice, blue_ice, frosted_ice
  • Blocks in this tag do not act a surface for ocean ruins to generate on.
impermeable glass, white_stained_glass, orange_stained_glass, magenta_stained_glass, light_blue_stained_glass, yellow_stained_glass, lime_stained_glass, pink_stained_glass, gray_stained_glass, light_gray_stained_glass, cyan_stained_glass, purple_stained_glass, blue_stained_glass, brown_stained_glass, green_stained_glass, red_stained_glass, black_stained_glass
  • Blocks in this tag do not let fluids or honey drip through.
infiniburn_end #infiniburn_overworld, bedrock
  • Used in the infiniburn preset of the end dimension type (determines which blocks stay on fire forever in the end)
infiniburn_nether #infiniburn_overworld
  • Used in the infiniburn preset of the nether dimension type (determines which blocks stay on fire forever in the nether)
infiniburn_overworld netherrack, magma_block
  • Used in the infiniburn preset of the overworld dimension type (determines which blocks stay on fire forever in the overworld)
  • Used in the #infiniburn_nether and #infiniburn_end block tags
snow_step_sound_blocks‌[upcoming: JE 1.17] snow, powder_snow
  • While the player walks in a block in this tag, it will use the step sound noises of the sound type of the block instead of the noise of the below block.
jungle_logs jungle_log, jungle_wood, stripped_jungle_log, stripped_jungle_wood
  • Cocoa beans can be placed on blocks in this tag.
  • Used in the #logs_that_burn block tag.
leaves jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves
  • Blocks in this tag don't obstruct many features from generating, such as bonus chests, trees, and huge mushrooms.
  • Used to determine placement rules for some transparent blocks
  • Blocks in this tag are destroyed 1.5x faster than normal with swords
  • Blocks in this tag are destroyed 15x faster than normal with shears and increment their stat usage
  • Blocks is this tag recognize shears as a correct tool
  • Parrots and ocelots can spawn in blocks in this tag
logs #logs_that_burn, #crimson_stems, #warped_stems
  • Used for one of the requirements for settling on a block position for the parrot wandering AI.
  • If a block in this tag is around a leaves block, the leaves block sets its distance block state to the distance the closest tagged block is.
  • Blocks in this tag do not stop trees from growing
  • Checks progress for the punch_tree tutorial step.
logs_that_burn #dark_oak_logs, #oak_logs, #acacia_logs, #birch_logs, #jungle_logs, #spruce_logs
  • Used in the #logs block tag.
mushroom_grow_block mycelium, podzol, crimson_nylium, warped_nylium
  • Mushrooms can be placed on blocks in this tag regardless of light level
  • Huge mushrooms can be grown on blocks in this tag regardless of light level
non_flammable_wood warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae, crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae, crimson_planks, warped_planks, crimson_slab, warped_slab, crimson_pressure_plate, warped_pressure_plate, crimson_fence, warped_fence, crimson_trapdoor, warped_trapdoor, crimson_fence_gate, warped_fence_gate, crimson_stairs, warped_stairs, crimson_button, warped_button, crimson_door, warped_door, crimson_sign, warped_sign, crimson_wall_sign, warped_wall_sign
nylium crimson_nylium, warped_nylium
  • Used as a check during generation certain vegetation in crimson and warped forests.
  • Crimson and warped roots and nether sprouts can be placed on blocks in this tag, as well as soul soil.
  • Netherrack is a valid bonemeal target only if a nearby block is in this tag, or if netherrack itself is in this tag.
  • A non-nylium block nearby causes bonemeal to be consumed without producing anything when used on netherrack.
  • It is still possible to spread nylium onto netherrack even if one or both nylium blocks are removed from the tag, as long as a block in the nylium tag is still nearby. This is because the check to grow nylium on the netherrack does not use the tag.
  • Fungi can be placed on blocks in this tag, as well as mycelium and soul soil.[more information needed]
oak_logs oak_log, oak_wood, stripped_oak_log, stripped_oak_wood
piglin_repellents soul_fire, soul_torch, soul_lantern, soul_wall_torch, soul_campfire
planks oak_planks, spruce_planks, birch_planks, jungle_planks, acacia_planks, dark_oak_planks, crimson_planks, warped_planks
portals nether_portal, end_portal, end_gateway
  • When an entity dismounts another entity, it is not put into blocks with this tag to prevent unwanted teleportation; instead, the entity dismounts at the ridden entity's location.
pressure_plates light_weighted_pressure_plate, heavy_weighted_pressure_plate, #wooden_pressure_plates, #stone_pressure_plates
prevent_mob_spawning_inside #rails
  • Mobs cannot spawn inside blocks in this tag.
rails rail, powered_rail, detector_rail, activator_rail
  • Minecarts can be placed and dispensed onto blocks in this tag.
  • When TNT minecarts explode, blocks in this tag that the minecart is on have a blast resistance of 0.
  • Used in determining rail directional placement. Adding blocks to this tag has no effect.
  • Used in determining minecart speed. Adding blocks to this tag has no effect on this behavior.
  • Used in the #prevent_mob_spawning_inside block tag.
sand sand, red_sand
saplings oak_sapling, spruce_sapling, birch_sapling, jungle_sapling, acacia_sapling, dark_oak_sapling
  • Blocks in this tag do not stop trees from growing
shulker_boxes shulker_box, black_shulker_box, blue_shulker_box, brown_shulker_box, cyan_shulker_box, gray_shulker_box, green_shulker_box, light_blue_shulker_box, light_gray_shulker_box, lime_shulker_box, magenta_shulker_box, orange_shulker_box, pink_shulker_box, purple_shulker_box, red_shulker_box, white_shulker_box, yellow_shulker_box
  • Fences, walls and panes do not connect to blocks in this tag.
  • If blocks are removed from this tag, the above blocks still disconnect when the shulker box opens
  • Used in the #guarded_by_piglins block tag.
signs #standing_signs, #wall_signs
  • Blocks in this tag are not destroyed by flowing water
  • Removing blocks from this tag has no effect
  • Used in the #wall_post_override block tag.
slabs #wooden_slabs, stone_slab, smooth_stone_slab, stone_brick_slab, sandstone_slab, purpur_slab, quartz_slab, red_sandstone_slab, brick_slab, cobblestone_slab, nether_brick_slab, petrified_oak_slab, prismarine_slab, prismarine_brick_slab, dark_prismarine_slab, polished_granite_slab, smooth_red_sandstone_slab, mossy_stone_brick_slab, polished_diorite_slab, mossy_cobblestone_slab, end_stone_brick_slab, smooth_sandstone_slab, smooth_quartz_slab, granite_slab, andesite_slab, red_nether_brick_slab, polished_andesite_slab, diorite_slab, cut_sandstone_slab, cut_red_sandstone_slab, blackstone_slab, polished_blackstone_brick_slab, polished_blackstone_slab
  • Blocks in this tag are viewed as slabs by ruined portal generation.
small_flowers dandelion, poppy, blue_orchid, allium, azure_bluet, red_tulip, orange_tulip, white_tulip, pink_tulip, oxeye_daisy, cornflower, lily_of_the_valley, wither_rose
soul_fire_base_blocks soul_sand, soul_soil
  • Blocks in this tag can support soul fire.
soul_speed_blocks soul_sand, soul_soil
  • Soul Speed increases the player's speed on blocks in this tag.
spruce_logs spruce_log, spruce_wood, stripped_spruce_log, stripped_spruce_wood
stairs #wooden_stairs, nether_brick_stairs, stone_brick_stairs, brick_stairs, purpur_stairs, quartz_stairs, red_sandstone_stairs, prismarine_brick_stairs, prismarine_stairs, dark_prismarine_stairs, polished_granite_stairs, smooth_red_sandstone_stairs, mossy_stone_brick_stairs, polished_diorite_stairs, mossy_cobblestone_stairs, end_stone_brick_stairs, stone_stairs, smooth_sandstone_stairs, smooth_quartz_stairs, granite_stairs, andesite_stairs, red_nether_brick_stairs, polished_andesite_stairs, diorite_stairs, blackstone_stairs, polished_blackstone_brick_stairs, polished_blackstone_stairs
  • Blocks in this tag are viewed as stairs by ruined portal generation.
standing_signs oak_sign, spruce_sign, birch_sign, acacia_sign, jungle_sign, dark_oak_sign, crimson_sign, warped_sign
stone_bricks stone_bricks, mossy_stone_bricks, cracked_stone_bricks, chiseled_stone_bricks
stone_pressure_plates stone_pressure_plate, polished_blackstone_pressure_plate
strider_warm_blocks lava
  • Unless a strider is in a block in this tag, it shivers.
tall_flowers sunflower, lilac, peony, rose_bush
  • Bees attempt to pollinate blocks in this tag
  • Used in the #flowers block tag.
trapdoors #wooden_trapdoors, iron_trapdoor
  • Mobs treat all blocks in this tag as trapdoors when pathfinding
  • Climbable blocks in this tag use the "<player> fell off a ladder" death message when applicable
underwater_bonemeals seagrass, #corals, #wall_corals
  • Blocks in this tag replace water source blocks (within 5 horizontal and 2 vertical blocks) when bone meal is used under water in warm ocean biomes.
  • If the blocks in this tag are customized, the behavior is applied to water source blocks in any biome. These blocks are not waterlogged by default.
unstable_bottom_center #fence_gates
  • Blocks in this tag cannot support lanterns and bells on their bottom side even if they would otherwise be able to.
valid_spawn grass_block, podzol
  • Used to determine if a location is a valid initial spawn position for the player.
walls cobblestone_wall, mossy_cobblestone_wall, brick_wall, prismarine_wall, red_sandstone_wall, mossy_stone_brick_wall, granite_wall, stone_brick_wall, nether_brick_wall, andesite_wall, red_nether_brick_wall, sandstone_wall, end_stone_brick_wall, diorite_wall, blackstone_wall, polished_blackstone_brick_wall, polished_blackstone_wall
  • Mobs treat blocks in this tag as fences when pathfinding.
  • Fence gates have the in_wall tag when next to a block in this tag.
  • Other walls (not defined by the tag), glass panes, and iron bars attempt to connect to non-solid blocks in this tag.
  • Blocks in this tag are viewed as walls by ruined portal generation.
wall_corals tube_coral_wall_fan, brain_coral_wall_fan, bubble_coral_wall_fan, fire_coral_wall_fan, horn_coral_wall_fan
  • Used to generate coral reefs.
  • When bone meal is used in warm and deep warm oceans, blocks in this tag may be placed on the sides of blocks.
  • The game may crash if added blocks do not have directional placement.
  • Used in the #underwater_bonemeals block tag.
wall_post_override torch, soul_torch, redstone_torch, tripwire, #signs, #banners, #pressure_plates
  • Blocks in this tag cause walls to become pillars, even if they are not solid.
wall_signs oak_wall_sign, spruce_wall_sign, birch_wall_sign, acacia_wall_sign, jungle_wall_sign, dark_oak_wall_sign, crimson_wall_sign, warped_wall_sign
warped_stems warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae
  • Used in the #logs block tag.
wart_blocks nether_wart_block, warped_wart_block
wither_immune barrier, bedrock, end_portal, end_portal_frame, end_gateway, command_block, repeating_command_block, chain_command_block, structure_block, jigsaw, moving_piston
  • Used to be determined what blocks Wither can't destroy.
wither_summon_base_blocks soul_sand, soul_soil
  • Blocks in this tag can be used in the base to summon the wither.
wooden_buttons oak_button, spruce_button, birch_button, jungle_button, acacia_button, dark_oak_button, crimson_button, warped_button
wooden_doors oak_door, spruce_door, birch_door, jungle_door, acacia_door, dark_oak_door, crimson_door, warped_door
  • Mobs that interact with wooden doors use this tag to detect wooden doors.
  • Only iron doors can be added to this tag. If added, villagers can open them.
  • Used in the #doors block tag.
wooden_fences oak_fence, acacia_fence, dark_oak_fence, spruce_fence, birch_fence, jungle_fence, crimson_fence, warped_fence
  • Used in the #fences block tag.
  • Fences in this tag attempt to connect to each other.
  • Fences in the #fences block tag do not attempt to connect to fences in this tag.
  • Fences not in either tag do not connect to fences in this tag, including other fences of the same type.
wooden_pressure_plates oak_pressure_plate, spruce_pressure_plate, birch_pressure_plate, jungle_pressure_plate, acacia_pressure_plate, dark_oak_pressure_plate, crimson_pressure_plate, warped_pressure_plate
wooden_slabs oak_slab, spruce_slab, birch_slab, jungle_slab, acacia_slab, dark_oak_slab, crimson_slab, warped_slab
wooden_stairs oak_stairs, spruce_stairs, birch_stairs, jungle_stairs, acacia_stairs, dark_oak_stairs, crimson_stairs, warped_stairs
wooden_trapdoors acacia_trapdoor, birch_trapdoor, dark_oak_trapdoor, jungle_trapdoor, oak_trapdoor, spruce_trapdoor, crimson_trapdoor, warped_trapdoor
wool white_wool, orange_wool, magenta_wool, light_blue_wool, yellow_wool, lime_wool, pink_wool, gray_wool, light_gray_wool, cyan_wool, purple_wool, blue_wool, brown_wool, green_wool, red_wool, black_wool
  • Blocks in this tag are broken 5× faster by shears and also increase the usage stat of shears.
  • Placing blocks in this tag under a note block sets the instrument used to guitar.
  • If blocks that cause note blocks to play a different instrument are added to this tag, they cause the note block to play guitar.

Entity types[edit]

Tag name Values Usage
arrows arrow, spectral_arrow
  • Used in the 'adventure/shoot_arrow.json' advancement file.
  • Used in the #impact_projectiles entity type tag.
beehive_inhabitors bee
  • Entities in this tag can be in beehives
impact_projectiles #arrows, snowball, fireball, small_fireball, egg, trident, dragon_fireball, wither_skull
  • Used to determine what entities can break chorus fruit when hit.
  • Entities can be removed from this tag, but only entities that activate targets work when added.
powder_snow_walkable_mobs‌[upcoming: JE 1.17] rabbit, endermite, silverfish
    • Entities in this tag can walk on top of powder snow.
raiders evoker, illusioner, pillager, ravager, vindicator, witch
  • Determines which entities get the glowing effect when ringing a bell.
  • Entities in this tag do not override a ravager's AI when riding one.
  • Used in the 'adventure/voluntary_exile.json' advancement file.
skeletons skeleton, stray, wither_skeleton
  • Makes creepers drop music discs when killed by a tagged mob
  • Used in the 'entities/creeper.json' loot table.

Fluids[edit]

Tag name Values Usage
lava lava, flowing_lava
  • Cactus breaks when next to this fluid
  • Used to enable the lava texture on a fluid
  • Used to create a smoke particle from rain instead of the normal rain particle
  • Used to enable lava-like fog
  • Items and experience orbs burn when in this fluid
  • When a bucket containing this fluid is placed, it uses the lava sound effect
  • Indicates a LAVA pathfinder node
  • Used in the process of forming stone/cobblestone/obsidian
  • Used in various strider pathfinding procedures
  • Striders cannot be ridden while submersed in fluids in this tag.
water water, flowing_water
  • Coral must have this on at least one side
  • Coral fans must be placed in this
  • Farmland uses this to determine hydration
  • Sugar Cane checks if this fluid, or a frosted ice block, is present next to the block below its base.
  • Sponges can absorb this fluid
  • Several particles use this to determine whether they should persist (bubble, bubble_column_up, current_down, underwater)
  • The drip particle internally uses this to determine its color.
  • Used to enable water fog
  • Determines if entities move as if they are in water
  • Indicates a WATER pathfinder node. Certain mobs pathfind toward this.
  • Boats check for this
  • Concrete solidifies in this.
  • Items and experience orbs float in this.
  • Guardians, squid, and turtles check for this
  • Fishing bobbers bob in this
  • Glass bottles may be filled in this
  • This fluid cannot be placed by buckets in the nether

Items[edit]

Tag name Values Usage
acacia_logs acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood
  • Used in the 'acacia_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
anvil anvil, chipped_anvil, damaged_anvil -
arrows arrow, tipped_arrow, spectral_arrow
  • Controls what items can be shot by bows and crossbows. Any items added to the tag can be shot and picked up as a normal arrow.
banners white_banner, orange_banner, magenta_banner, light_blue_banner, yellow_banner, lime_banner, pink_banner, gray_banner, light_gray_banner, cyan_banner, purple_banner, blue_banner, brown_banner, green_banner, red_banner, black_banner
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
beacon_payment_items netherite_ingot, emerald, diamond, gold_ingot, iron_ingot
  • Used by beacons to check which items can be placed inside of its GUI to select an effect.
beds red_bed, black_bed, blue_bed, brown_bed, cyan_bed, gray_bed, green_bed, light_blue_bed, light_gray_bed, lime_bed, magenta_bed, orange_bed, pink_bed, purple_bed, white_bed, yellow_bed -
birch_logs birch_log, birch_wood, stripped_birch_log, stripped_birch_wood
  • Used in the 'birch_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
boats oak_boat, spruce_boat, birch_boat, jungle_boat, acacia_boat, dark_oak_boat
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 1200.
buttons #wooden_buttons, stone_button, polished_blackstone_button -
candles‌[upcoming: JE 1.17] candle, white_candle, orange_candle, magenta_candle, light_blue_candle, yellow_candle, lime_candle, pink_candle, gray_candle, light_gray_candle, cyan_candle, purple_candle, blue_candle, brown_candle, green_candle, red_candle, black_candle
  • Cakes use this tag to determine if a candle item can be placed on it or not.
  • Adding items to this tag has no effect.
carpets white_carpet, orange_carpet, magenta_carpet, light_blue_carpet, yellow_carpet, lime_carpet, pink_carpet, gray_carpet, light_gray_carpet, cyan_carpet, purple_carpet, blue_carpet, brown_carpet, green_carpet, red_carpet, black_carpet
  • Used to check whether or not an item can go in the decoration slot of a llama, but items other than carpets do not change the llama visually.
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 67.
coals coal, charcoal
  • Used in the 'campfire.json' advancement and recipe files.
creeper_drop_music_discs music_disc_13, music_disc_cat, music_disc_blocks, music_disc_chirp, music_disc_far, music_disc_mall, music_disc_mellohi, music_disc_stal, music_disc_strad, music_disc_ward, music_disc_11, music_disc_wait
  • Used to determine what a creeper drops when killed by a skeleton.
  • Used in the 'entities/creeper.json' loot table.
  • Used in the #music_discs item tag.
crimson_stems crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae
  • Used in the 'crimson_planks.json' advancement and recipe files.
  • Used in the #logs item tag.
dark_oak_logs dark_oak_log, dark_oak_wood, stripped_dark_oak_log, stripped_dark_oak_wood
  • Used in the 'dark_oak_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
doors #wooden_doors, iron_door -
fences #wooden_fences, nether_brick_fence -
fishes cod, cooked_cod, salmon, cooked_salmon, pufferfish, tropical_fish
  • Used by dolphins to pick a player to swim to. The item can be both in the main and offhand.
  • Feeding a dolphin one of these items increases its 'trust' in you.
  • Items in this tag add 1 to the fish_caught statistic when caught through fishing.
flowers #small_flowers, #tall_flowers
  • Items in this tag can be used to breed bees.
  • Bees follow players holding items in this tag.
freeze_immune_wearables‌[upcoming: JE 1.17] leather_boots, leather_leggings, leather_chestplate, leather_helmet
  • Entities with an item in this tag in any armor slot will not be able to freeze.
gold_ores gold_ore, nether_gold_ore
  • Used in the 'gold_ingot.json' and 'gold_ingot_from_blasting.json' advancement and recipe files.
  • Used in the #piglin_loved item tag.
ignored_by_piglin_babies‌[upcoming: JE 1.17] leather
  • Baby piglins will not attempt to pick up items in this tag. Baby piglins still follow the other rules adult piglins follow.
  • Takes precedence over piglin_food and piglin_loved item tags when an item is in both.
jungle_logs jungle_log, jungle_wood, stripped_jungle_log, stripped_jungle_wood
  • Used in the 'jungle_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
leaves jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves -
lectern_books written_book, writable_book
  • Controls what items can be put in a lectern. Items cannot be added to this tag, only removed.
logs #logs_that_burn, #crimson_stems, #warped_stems
  • Used in various checks to either skip or progress with the "punch_tree" tutorial step.
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in the 'campfire.json', 'smoker.json', and 'soul_campfire.json' recipe files.
logs_that_burn #dark_oak_logs, #oak_logs, #acacia_logs, #birch_logs, #jungle_logs, #spruce_logs
  • Used in the 'charcoal.json' advancement and recipe files.
  • Used in the #logs item tag.
music_discs #creeper_drop_music_discs, music_disc_pigstep -
non_flammable_wood warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae, crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae, crimson_planks, warped_planks, crimson_slab, warped_slab, crimson_pressure_plate, warped_pressure_plate, crimson_fence, warped_fence, crimson_trapdoor, warped_trapdoor, crimson_fence_gate, warped_fence_gate, crimson_stairs, warped_stairs, crimson_button, warped_button, crimson_door, warped_door, crimson_sign, warped_sign
  • Items in this tag cannot be used as fuel in a furnace.
  • If items are removed from this tag, they can be used as fuel only if they are part of a tag that can be used as fuel.
oak_logs oak_log, oak_wood, stripped_oak_log, stripped_oak_wood
  • Used in the 'oak_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
piglin_food‌[upcoming: JE 1.17] porkchop, cooked_porkchop
  • Piglins can "eat" items in this tag.
    • Eating refers to the piglin seeking out and picking up an item without appearing in its inventory, thus vanishing.
piglin_loved #gold_ores, gold_block, gilded_blackstone, light_weighted_pressure_plate, gold_ingot, bell, clock, golden_carrot, glistering_melon_slice, golden_apple, enchanted_golden_apple, golden_helmet, golden_chestplate, golden_leggings, golden_boots, golden_horse_armor, golden_sword, golden_pickaxe, golden_shovel, golden_axe, golden_hoe
  • Piglins actively seek out items in this tag
  • Piglins view players holding items in this tag as holding a "loved" item
  • Used in the distract_piglin.json advancement file
piglin_repellents soul_torch, soul_lantern, soul_campfire
  • Piglins do not attempt to pick up items in this tag.
planks oak_planks, spruce_planks, birch_planks, jungle_planks, acacia_planks, dark_oak_planks, crimson_planks, warped_planks
  • Items in this tag can be used to repairs shields in an anvil.
  • Used in various checks to either skip or progress with the "craft_planks" tutorial step.
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in these 3 advancement files and these 39 recipe files.
rails rail, powered_rail, detector_rail, activator_rail -
sand sand, red_sand
  • Used in the 'glass.json' advancement and recipe files.
saplings oak_sapling, spruce_sapling, birch_sapling, jungle_sapling, acacia_sapling, dark_oak_sapling
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 100.
signs oak_sign, spruce_sign, birch_sign, acacia_sign, jungle_sign, dark_oak_sign, crimson_sign, warped_sign
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 200.
slabs #wooden_slabs, stone_slab, smooth_stone_slab, stone_brick_slab, sandstone_slab, purpur_slab, quartz_slab, red_sandstone_slab, brick_slab, cobblestone_slab, nether_brick_slab, petrified_oak_slab, prismarine_slab, prismarine_brick_slab, dark_prismarine_slab, polished_granite_slab, smooth_red_sandstone_slab, mossy_stone_brick_slab, polished_diorite_slab, mossy_cobblestone_slab, end_stone_brick_slab, smooth_sandstone_slab, smooth_quartz_slab, granite_slab, andesite_slab, red_nether_brick_slab, polished_andesite_slab, diorite_slab, cut_sandstone_slab, cut_red_sandstone_slab, blackstone_slab, polished_blackstone_brick_slab, polished_blackstone_slab -
small_flowers dandelion, poppy, blue_orchid, allium, azure_bluet, red_tulip, orange_tulip, white_tulip, pink_tulip, oxeye_daisy, cornflower, lily_of_the_valley, wither_rose
  • Items in this tag can be used to make suspicious stew. Adding items does not allow them to be used in suspicious stew, but removing them disallows them from being used.
  • Used to test what can be fed to brown mooshrooms.
  • Used in the #flowers item tag.
soul_fire_base_blocks soul_sand, soul_soil
  • Used in the 'soul_campfire.json' and 'soul_torch.json' advancement and recipe files.
spruce_logs spruce_log, spruce_wood, stripped_spruce_log, stripped_spruce_wood
  • Used in the 'spruce_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
stairs #wooden_stairs, cobblestone_stairs, sandstone_stairs, nether_brick_stairs, stone_brick_stairs, brick_stairs, purpur_stairs, quartz_stairs, red_sandstone_stairs, prismarine_brick_stairs, prismarine_stairs, dark_prismarine_stairs, polished_granite_stairs, smooth_red_sandstone_stairs, mossy_stone_brick_stairs, polished_diorite_stairs, mossy_cobblestone_stairs, end_stone_brick_stairs, stone_stairs, smooth_sandstone_stairs, smooth_quartz_stairs, granite_stairs, andesite_stairs, red_nether_brick_stairs, polished_andesite_stairs, diorite_stairs, blackstone_stairs, polished_blackstone_brick_stairs, polished_blackstone_stairs -
stone_bricks stone_bricks, mossy_stone_bricks, cracked_stone_bricks, chiseled_stone_bricks
  • Used in these 3 advancement files.
stone_crafting_materials cobblestone, blackstone
  • Used in the 'furnace.json' advancement and recipe files and the 'brewing_stand.json' recipe file.
stone_tool_materials cobblestone, blackstone
  • Used in these 6 advancement and recipe files.
  • Items in this tag can be used to repair stone tools in an anvil.
tall_flowers sunflower, lilac, peony, rose_bush
trapdoors #wooden_trapdoors, iron_trapdoor -
walls cobblestone_wall, mossy_cobblestone_wall, brick_wall, prismarine_wall, red_sandstone_wall, mossy_stone_brick_wall, granite_wall, stone_brick_wall, nether_brick_wall, andesite_wall, red_nether_brick_wall, sandstone_wall, end_stone_brick_wall, diorite_wall, blackstone_wall, polished_blackstone_brick_wall, polished_blackstone_wall -
warped_stems warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae
  • Used in the 'warped_planks.json' advancement and recipe files.
wooden_buttons oak_button, spruce_button, birch_button, jungle_button, acacia_button, dark_oak_button, crimson_button, warped_button
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 100.
  • Used in the #buttons item tag.
wooden_doors oak_door, spruce_door, birch_door, jungle_door, acacia_door, dark_oak_door, crimson_door, warped_door
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 200.
  • Used in the #doors item tag.
wooden_fences oak_fence, acacia_fence, dark_oak_fence, spruce_fence, birch_fence, jungle_fence, crimson_fence, warped_fence
wooden_pressure_plates oak_pressure_plate, spruce_pressure_plate, birch_pressure_plate, jungle_pressure_plate, acacia_pressure_plate, dark_oak_pressure_plate, crimson_pressure_plate, warped_pressure_plate
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
wooden_slabs oak_slab, spruce_slab, birch_slab, jungle_slab, acacia_slab, dark_oak_slab, crimson_slab, warped_slab
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 150.
  • Used in the 'barrel.json' and 'composter.json advancement and recipe files.
  • Used in the 'daylight_detector.json' and 'lectern.json' recipe files.
  • Used in the #slabs item tag.
wooden_stairs oak_stairs, spruce_stairs, birch_stairs, jungle_stairs, acacia_stairs, dark_oak_stairs, crimson_stairs, warped_stairs
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in the #stairs item tag.
wooden_trapdoors acacia_trapdoor, birch_trapdoor, dark_oak_trapdoor, jungle_trapdoor, oak_trapdoor, spruce_trapdoor, crimson_trapdoor, warped_trapdoor
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in the #trapdoors item tag.
wool white_wool, orange_wool, magenta_wool, light_blue_wool, yellow_wool, lime_wool, pink_wool, gray_wool, light_gray_wool, cyan_wool, purple_wool, blue_wool, brown_wool, green_wool, red_wool, black_wool
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 100.
  • Used in the 'painting.json' advancement and recipe files.

History[edit]

Java Edition
1.1317w49aAdded tags for blocks and items.
Added the vanilla block and item tags planks and wool.
17w49bFunction can now be tagged.
Functions tagged in tick now run every tick in the beginning of the tick.
Added the vanilla block tag flower_pots.
Added the vanilla block and item tags buttons, carpets, doors, logs, saplings and stone_bricks.
17w50aAdded the vanilla block and item tags wooden_buttons and wooden_doors.
Updated the vanilla block and item tags buttons and doors to include stone_button and iron_door respectively.
18w01aFunctions tagged in load now runs once after a (re)load.
Added the vanilla block tag anvil.
18w02aAdded the vanilla block tag enderman_holdable.
18w06aAdded the vanilla block and item tags banners, wooden_pressure_plates, wooden_slabs, and wooden_stairs.
Added the vanilla item tag boats.
18w07aAdded the vanilla block tags slabs, stairs and water_hacked.
Added the block and item tags acacia_logs, birch_logs, dark_oak_logs, jungle_logs, oak_logs, and spruce_logs
18w07bAdded the block tag waterlogged.
Added the block and item tags rails and sand.
18w09aAdded vanilla block and item tag coral.
The water_hacked tag now includes chests.
18w10aAdded the block and item tag coral_plants.
The waterlogged block tag now includes coral plants.
18w10cRemoved the block tags water_hacked and waterlogged.
18w19aAdded the block tag leaves, the fluid tags water and lava, and the item tags fishes and leaves.
pre8Added the block tag wall_corals and impermeable.
1.13.118w31aAdded the block tag underwater_bonemeals.
1.1418w43aAdded the block tags bamboo_plantable_on, dirt_like, signs, small_flowers, standing_signs, wall_signs, walls.
Modified block tags enderman_holdable,flower_pots,slabs,stairs.
Added the entity type tag skeletons.
Added the item tags music_discs,signs,small_flowers,walls.
Modified item tags slabs,stairs.
18w44aAdded block and item tag beds
1.14.1Pre-Release 1Functions in a tag are now executed in the order they are listed.
1.1519w34aAdded bee_growables, beehives, crops, flowers, and tall_flowers block tags.
Added flowers and tall_flowers item tags.
19w36aAdded beehive_inhabitors entity tag.
19w41aRemoved dirt_like block tag.
19w42aAdded lectern_books item tag.
19w44aAdded shulker_boxes block tag.
19w45aAdded arrows entity tag.
Pre-Release 2Added portals block tag.
1.1620w06aAdded crimson_stems, fire, nylium, warped_stems, and wart_blocks block tags.
Added crimson_stems and warped_stems item tags.
Added crimson and warped items to planks, standing_signs, wall_signs, wooden_buttons, wooden_doors, wooden_fences, wooden_pressure_plates, wooden_slabs, wooden_stairs, and wooden_trapdoors block tags.
Added crimson and warped items to planks, signs, wooden_buttons, wooden_doors, wooden_fences, wooden_pressure_plates, wooden_slabs, wooden_stairs, and wooden_trapdoors item tags.
The slabs block and item tags now use the respective wooden_slabs tag.
20w07aAdded beacon_base_blocks, wall_post_override, and wither_summon_base_blocks block tags.
Added beacon_payment_items item tag.
Removed netherrack and added fungi, roots, and nylium variants to the enderman_holdable block tag.
20w09aAdded climbable block tag.
Added impact_projectiles entity tag.
Added potted crimson fungus, warped fungus, nether sprouts, and crimson roots to the flower_pots block tag.
20w10aAdded hoglin_repellents and piglin_repellents block tags.
Added crimson hyphae, warped hyphae, and the stripped variants to their respective stem block and item tags.
20w11aAdded gold_ores and soul_speed_blocks block tags.
Added gold_ores and piglin_repellents item tags.
Added twisted vines to the climbable block tag.
Added crying obsidian to the dragon_immune block tag.
Added potted warped fungus to the hoglin_repellents block tag.
20w12aAdded soul_fire_base_blocks block tag.
20w13aAdded the logs_that_burn and non_flammable_wood block and item tags.
Added the strider_warm_blocks block tag.
The logs block and item tags now contain the logs_that_burn, crimson_stems, and warped_stems block and item tags.
Added the respawn anchor the the dragon_immune block tag.
20w14aAdded nether portals and respawn anchors to the hoglin_repellents block tag.
20w15aAdded the campfires and guarded_by_piglins block tags.
Added the furnace_materials, soul_fire_base_blocks, and stone_tool_materials item tags.
Added polished blackstone, and (where applicable) blackstone blocks and items to the buttons, slabs, stairs, and walls block and item tags.
Added soul campfires to the piglin_repellents block tag.
Added the #signs block tag and removed lanterns and soul fire lanterns from the wall_post_override block tag.
20w16aAdded the creeper_drop_music_discs item tag.
Changed the music_discs item tag to use the #creeper_drop_music_discs item tag and the pigstep music disc.
20w17aAdded the pressure_plates and stone_pressure_plates block tags.
Added the banners and signs block tags to the wall_post_override block tag.
20w18aAdded soul campfires to the piglin_repellents item tag.
20w19aAdded the prevent_mob_spawning_inside block tag.
The slabs block and item tags now use the respective wooden_slabs tag.
20w20aAdded the piglin_loved item tag.
20w21aRemoved wither roses from the prevent_mob_spawning_inside block tag.
20w22aAdded the fence_gates and unstable_bottom_center block tags.
Pre-release 1Added gold nuggets to the piglin_loved item tag.
The piglin_loved item tag now uses the gold_ores item tag.
Removed sweet berry bushes from the prevent_mob_spawning_inside block tag.
Pre-release 3Added infiniburn_end, infiniburn_nether, and infiniburn_overworld block tags.
Removed gold nuggets from the piglin_loved item tag.
1.16.220w27aAdded the mushroom_grow_block block tag.
20w28aAdded the base_stone_nether and base_stone_overworld block tags.
Added the stone_crafting_materials item tag.
Removed the furnace_materials item tag.
Upcoming Java Edition
1.1720w45aAdded the candle_cakes, candles, cauldrons, and crystal_sound_blocks block tags.
Added the candles, ignored_by_piglin_babies, and piglin_food item tags.
20w46aAdded the snow_step_sound_blocks block tag.
Added the powder_snow_walkable_mobs entity type tag.
Added powder snow cauldrons to the cauldrons block tag.
20w48aAdded the freeze_immune_wearables item tag.
The snow_step_sound_blocks block tag has been renamed to inside_step_sound_block.

Issues[edit]

Issues relating to "Tag" are maintained on the bug tracker. Report issues there.