Commands/tag

tag
Permission level required	2 ‌ 1 ‌
Restrictions	Cheat only‌

Controls scoreboard tags on individual entities. In Java Edition, the number of tags owned by an entity cannot exceed 1024.

Java Edition note: This is distinct from entity type tags, which are applied to entity types and can't be changed by commands.

Syntax

• Java Edition

tag <targets> add <name>

Adds a tag to the targets.

tag <targets> list

Lists all tags on the targets.

tag <targets> remove <name>

Removes a tag from the targets.

• Bedrock Edition

tag <entity: targets> add <name: string>

Adds a tag to the targets.

tag <entity: targets> remove <name: string>

Removes a tag from the targets.

tag <entity: targets> list

Lists all tags on the targets.

Arguments

JE: <targets>: entity
BE: entity: target: WildcardCommandSelector<Actor>

Specifies the command's target.

In Java Edition, must be a player name, a target selector or a UUID.

In Bedrock Edition, must be either a target selector, a player name, or * for all score holders.

JE: <name>: string
BE: name: string: basic_string

Specifies the name of the tag to be added into or removed from the targets.

Must be a string. In Java Edition, it must be in a single word (Allowed characters include: -, +, ., _, A-Z, a-z, and 0-9). In Bedrock Edition, it must be a single word that has no space or a quoted string.

Result

Command	Trigger	Java Edition	Bedrock Edition
any	the arguments are not specified correctly	Unparseable	Unparseable
	<targets> or player: target fails to resolve to one or more entities (named players must be online)	Failed	Failed
/tag ... add ...	All selected entities meet one or more of the following conditions: it already had the specified tag it already has 1024 tags‌
/tag ... remove ...	there's no entity whose tag is removed
/tag ... list ...	there's no entity that has any tag		Successful
any	Otherwise	Successful

Output

Command	Edition	Situation	Success Count	/execute store success ...	/execute store result ...
any	Java Edition	On fail	0	0	0
/tag ... add ...		On success	1	1	the number of entities who get a new tag
/tag ... remove ...		On success	1	1	the number of entities whose tags are remove
/tag ... list		On success	1	1	the number of all tags the specified entities have
any	Bedrock Edition	On fail	0	N/A	N/A
		On success	1	N/A	N/A

History

Java Edition
1.13		17w45a			Added /tag.
Bedrock Edition
1.9		beta 1.9.0.2			Added /tag.

See also

• /team

Commands 

View at: Template:Commands/content [edit]