#Tag Manager

The Gameplay Tags settings page is where you create, organize, document, import, export, and validate your project's tag database.

Gameplay Tags settings window with hierarchy and details panel — Gameplay Tags settings window with the hierarchy on the left and the details panel on the right.

#Open the Tag Manager

Open Game Creator's Settings window and select Gameplay Tags.

#Interface Overview

The tag manager is split into two main areas:

Area	Purpose
Hierarchy	Browse, search, create, rename, delete, duplicate, and reorganize tags.
Details	View the selected tag, edit its description, copy its GUID, and perform tag actions.

#Create Tags

Start with a small set of root categories:

Character
Damage
Faction
Interaction
Item
Quest
World

Then create child tags as your project needs them:

Character.State.Stunned
Damage.Type.Fire
Faction.Enemy
Interaction.Usable.Door
Quest.Main.Completed

#Valid Paths

Valid tag paths:

Are not empty.
Do not start or end with a dot.
Do not contain double dots.
Do not contain /.
Do not contain empty segments.

#Rename Tags

Select a tag and use Rename, double-click the row, press F2, or use the context menu.

Renaming a parent tag renames its subtree. For example:

Damage.Element.Fire

can become:

Damage.Type.Fire

Important
Rename and reparent preserve definition GUIDs and create redirects for moved paths, so old serialized paths resolve safely at runtime.

#Delete Tags

Deleting a tag removes that tag and its descendants from the database after confirmation.

Important
Delete removes tag definitions and descendants. It does not scan project assets or create redirects, so existing serialized references may become missing.

Use search to filter large hierarchies:

Fire
Quest.Main
Faction
Interaction.Usable

Keyboard shortcuts supported by the manager include:

Shortcut	Action
`F2` or `Enter`	Rename selected tag.
`Delete` or `Backspace`	Delete selected tag.
`Ctrl+C` or `Cmd+C`	Copy selected tag path.
Left Arrow	Collapse selected tag or move to parent.
Right Arrow	Expand selected tag.

#Details Panel

Selecting a tag shows its details.

Field	Purpose
Full Path	The complete tag path used by Actions, Conditions, and code.
Parent	The parent category, if any.
Description	Notes for designers about when to use the tag.
GUID	Internal identity value that can be shown, hidden, or copied.
Children / Descendants	Quick summary of hierarchy depth.

Right-click a tag row to access common actions:

Add Child Tag
Add Root Tag
Rename
Delete Tag
Copy Tag Path
Duplicate

Tag row context menu with common management actions.

#Import and Export

The tag manager supports JSON import and export.

Use Export before large changes, or when sharing a tag database between projects.

Use Import to load a JSON tag database.

Gameplay Tags import/export dialog — Import or export workflow for sharing or backing up the Gameplay Tags database.

#Validation

Validation can report:

Invalid paths.
Duplicate paths.
Redirect targets that no longer exist.
Redirect cycles.

Run validation after imports, large renames, or database cleanup.