Datapack Codex

Tag (Bedrock Edition)

Minecraft Wiki article. Categories: Unknown_Bedrock_version_history, Bedrock_Edition

📌 Mirrored from Minecraft Wiki

This article is reproduced from Tag (Bedrock Edition) on the Minecraft Wiki. Mirrored from revision 3494338. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.

On this page

Tags (also called registry tags) in behavior packs allow players to group different game elements together.

Usage

Tags are defined in the block's, item's, and biome's behavior definitions, usually as part of the minecraft:tags component. Custom tags do not need a registry to be validated.

JSON format

  • [NBT Compound / JSON Object] The root object.
    • [NBT Compound / JSON Object] minecraft:<definition>: The type of definition. Must be a block, item, or biome.
      • [NBT Compound / JSON Object] components
        • [NBT Compound / JSON Object] minecraft:tags (Biomes and items only)
          • [NBT List / JSON Array] tags: List of tags.
            • [String]: A tag name.
        • [NBT Compound / JSON Object] tag:<tag name>: (Blocks only) <tag name> is replaced by the name of the tag. Object must be empty.

A block, item, or biome may have multiple tags. Combinations of custom and vanilla tags are authorized.

Tags can be used in command queries and behavior pack molang and scripting.

List of tag types

This section lists the tag types that are used by the game to affect its behavior in various ways, as well as those that are populated by default, even if the game does not use them to control some behavior.

History

Bedrock Edition
?Added tags for blocks, items, and biomes.
1.19.40Preview 1.19.40.22Tags can now be used in recipe files.
1.20.50Preview 1.20.50.20Item tags are now specified under an array within the minecraft:tags component rather than under individual tag: components.
1.20.60Preview 1.20.60.24Biome tags are now specified under an array within the minecraft:tags component rather than as loose JSON objects.
26.10Preview 26.10.23Block tags are now specified under an array within the minecraft:tags component rather than under individual tag: components.
Block tags now require a namespace.

Issues

Issues relating to "Tag" are maintained on the bug tracker. Issues should be reported and viewed there.

See also

Sources