# Tagging services

### Tagging overview

Tagging services in Appear is a flexible and useful way to represent relationships across your systems, teams, and organisational structure.

Tags are added directly from the **Service Details view** in the **Catalog**. You can apply them however you see fit — whether to represent environments, teams, business domains, or deployment regions.

### Tagging a service

To tag a service, navigate to a service detail view and enter a new line in the editable section at the top half of the column.

From there, invoke the block editor by typing '/' (forward-slash) and select **Tags**.

Begin typing your tag, or select an existing one. You can add as many or as few as you like.

<figure><img src="https://4271365556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLEIq2n49ebGjzhVFTmTm%2Fuploads%2FlQTDQwsdZnRVy8fNNHlH%2FCleanShot%202025-05-04%20at%2022.47.30.png?alt=media&#x26;token=e44d0bea-58db-4539-9686-4ab826e9e237" alt=""><figcaption></figcaption></figure>

Use tags to organise, navigate, and assess your API ecosystem in a way that aligns with how your team or organisation works.

### Tagging concepts

Tags in Appear are **not standalone objects** in the database — they only exist **in relation to services**. This means the list of available tags is simply an aggregate of all tags used across all services.

When **adding a tag to a service**, we show tags from all environments and versions to encourage consistency and reuse across your system.

However, when **grouping or filtering by tags**, we scope them to the current branch or environment. This ensures the results are relevant to the specific context you're viewing — like filtering only by tags used in your staging environment

### Tagging FAQs

<details>

<summary>Can my team see my tags?</summary>

Yes, tags are shared across your team and organisation.

</details>

<details>

<summary>Can I delete or edit my tags?</summary>

No, there is no central way to delete or manage tags once created. This facility is coming soon. If you need help with this, please  [get in touch](https://docs.appear.sh/getting-started/get-in-touch).

</details>

***

If you have any queries or require support with the above instructions, please [get in touch](https://docs.appear.sh/getting-started/get-in-touch) with us.
