> For the complete documentation index, see [llms.txt](https://conusyntax.gitbook.io/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://conusyntax.gitbook.io/products/ui-and-gameplay-tag-architecture.md).
# UI & Gameplay Tag Architecture
**Character Creator Pro** is built around **Gameplay Tag driven** **architecture**. Most Widget Blueprints rely on Gameplay Tag variables to determine which action should be executed when a player interacts with UI elements.
{% hint style="info" %}
For example, a dropdown button with the tag `CharacterCreator.Gender` triggers the gender selection logic, while a stepper button with the tag `CharacterCreator.Groom.Hairstyle` changes hairstyle assets.
{% endhint %}
Because of this, all required Gameplay Tags must exist in the **DT\_CharacterCreatorTags** table, found in **Data/DataTables**. This is where any new tags should be defined.
#### Adding New Tags
1. Open the **DT\_CharacterCreatorTags** table.
2. Click **Add** to create a new row.
3. Enter your new **Tag** (e.g., `CharacterCreator.Haircards.Hairstyle`).
{% hint style="warning" %}
Do not rename existing tags unless you also update every widget and switch node using them. Changing tag names without updating references will break functionality.
If you rename a tag, you must manually update:
* Every **Widget Blueprint** referencing that tag.
* Every **Switch on Gameplay Tag** node.
{% endhint %}
Widgets use **Switch on Gameplay Tag** logic internally. When a widget is clicked or modified, the tag informs the system which function to execute.
To link a widget to a specific action, go to **Details** ➞ **Button** ➞ **Attributes**, locate the **Gameplay Tag** and assign the appropriate tag that triggers that specific action.
{% hint style="warning" %}
If the Gameplay Tag is left empty or misspelled, the widget will not trigger any changes.
{% endhint %}
