> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/admin-portal/manage-tags.md).

# Manage tags

Tags are reusable labels used to organize, search, and group displays and Mago Remote Agents.  Tags can also control membership in tag-based assignments.

### Create a tag

1. In the Administration Portal, select **Tags**.
2. Select **New**.
3. Enter a name for the tag.
4. Select **Create**.

The new tag becomes available when editing supported displays and Agents.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2F8TaBidQINyViXqhacW5G%2Fimage.png?alt=media&amp;token=88ca6d9b-5bf3-4232-84c4-634294e1791d" alt=""><figcaption></figcaption></figure>

### Tag naming

Use a consistent naming convention that reflects how resources are managed.

Tags can identify:

* Location
* Department
* Device purpose
* Environment
* Support group
* Configuration type

Example tags include:

* Dubai
* Boardrooms
* Reception
* Showroom
* Training
* Production
* Test Devices

Avoid creating multiple tags with slightly different names for the same purpose.

### Review tag usage

The Tags page shows how many resources are assigned to each tag.

Select a tag to review its details and available actions.

Before changing or deleting a tag, check whether it is used by a tag-based assignment.

### Rename a tag

1. Select **Tags**.
2. Select the required tag.
3. Change its name.
4. Select **Save**.

Renaming a tag updates the name everywhere the tag is used.

{% hint style="warning" %}
Renaming a tag can affect operational procedures or documentation that refers to its previous name.
{% endhint %}

### Delete a tag

1. Select **Tags**.
2. Select the required tag.
3. Open the actions menu.
4. Select **Delete**.
5. Confirm the deletion.

Deleting a tag removes it from every display and Agent to which it is assigned. It does not delete those resources.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2F58JLGphwnZIOASlLZTtO%2Fimage.png?alt=media&amp;token=cd06e326-bdd6-49d8-b731-17044f848ee6" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Deleting a tag can change membership in tag-based assignments. This may cause assigned policies to stop applying to affected resources.
{% endhint %}

### Assign tags to resources

Tags are assigned while editing a display or Agent.

For instructions, see:

* **View and edit display information**
* **View, edit, and share an Agent**
* **Tag-based assignments**
