# Tags

You can use tags to categorize, sort, and even filter workspaces based on the tags.

You can manage tags for the organization in the Settings panel. This section lets you create and remove tags. Alternatively, you can add existing tags or create new ones in the [Workspace overview page](https://docs.terrakube.io/2.20.0/user-guide/workspaces/overview).

### Creating a Tag

Once you are in the desired organization, click the **Settings** button, then in the left menu select the **Tags** option and click the **Add global variable** button

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-0e6b47cf71176b15c97197bcb8614b2d5974215e%2Fimage%20(87).png?alt=media" alt=""><figcaption></figcaption></figure>

In the popup, provide the required values. Use the below table as reference:

| Field | Description     |
| ----- | --------------- |
| Name  | Unique tag name |

Finally click the **Save tag** button and the variable will be created

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-3ab920893f0f493acf230b2ccc087769da06aeb0%2Fimage%20(117).png?alt=media" alt=""><figcaption></figcaption></figure>

You will see the new tag in the list. And now you can use the tag in the workspaces within the organization

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-8c1f39ee53c57a604e7119f3d6b626ed2f3e3d5f%2Fimage%20(86).png?alt=media" alt=""><figcaption></figcaption></figure>

### Edit a Tag

Click the **Edit** button next to the tag you want to edit.

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-66fd5b523a1df0fe4e8200e6b885c7c038cb9f3a%2FScreenshot%202023-06-19%20at%2010.34.59.png?alt=media" alt=""><figcaption></figcaption></figure>

Change the fields you need and click the **Save tag** button

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-cd86058bdce886be7e6fe788af2aa5441b2fcb6f%2FScreenshot%202023-06-19%20at%2010.38.45.png?alt=media" alt=""><figcaption></figcaption></figure>

### Delete a Tag

Click the **Delete** button next to the tag you want to delete, and then click the Yes button to confirm the deletion. Please take in consideration the deletion is irreversible and the tag will be removed from all the workspaces using it.

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-cbcdcabbb59b18c1ee12b2a6be782667da3eb15a%2Fimage%20(115).png?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.terrakube.io/2.20.0/user-guide/organizations/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
