# Tags Overview

Source: https://userguide.qualytics.io/tags/overview/

This hub gathers the documentation for tags, the labels you put on your data assets in Qualytics. It is organized in three parts:

- **Deep Dive** explains what tags are and how they influence Qualytics, starting with a map of the section.
- **How-tos** walk through each task step by step, from creating a tag to moving it across many assets.
- **Reference** holds the Tags API and the FAQ.

> **Info: Permissions**
>
> Everyone can see the Tags list and each tag's page. Applying a tag to an asset needs the team permission that lets you edit that asset. Global tags are managed by Admins, and a team's tags also by the users whose team holds the **Editor** team permission. See [Tag Permissions](https://userguide.qualytics.io/tags/deep-dive/permissions/) for the full matrix.

---

## Deep Dive

Start here to understand tags before you use them. **Getting Started** maps the whole section, **Introduction** and **How It Works** explain what tags are and how they influence Qualytics, and the remaining pages cover weights, team and external tags, the tag page, real scenarios, guidelines, and permissions.

- **Getting Started**

  A map of the Tags documentation: what each part covers and when to read it.

  [Getting Started](https://userguide.qualytics.io/tags/deep-dive/getting-started/)
- **Introduction**

  What a tag is in Qualytics and what it is for, in a few lines.

  [Introduction](https://userguide.qualytics.io/tags/deep-dive/introduction/)
- **How It Works**

  How tags influence quality scores, check importance, Flows, and operations, and how a tag spreads through a datastore.

  [How It Works](https://userguide.qualytics.io/tags/deep-dive/how-it-works/)
- **Weight Modifier**

  How a tag's weight changes quality scores and the importance of the checks that carry it.

  [Weight Modifier](https://userguide.qualytics.io/tags/deep-dive/weight-modifier/)
- **Global Tags**

  Tags open to the whole workspace: what they are for, who manages them, and how a tag becomes global.

  [Global Tags](https://userguide.qualytics.io/tags/deep-dive/global-tags/)
- **Team Tags**

  Tags scoped to one team: who sees them, where they can go, and what happens when the scope changes.

  [Team Tags](https://userguide.qualytics.io/tags/deep-dive/team-tags/)
- **External Tags**

  Tags imported from a connected data catalog, and what stays read-only in Qualytics.

  [External Tags](https://userguide.qualytics.io/tags/deep-dive/external-tags/)
- **Tag Page**

  The page of a single tag: its summary, timeline, tagged assets, map, and actions.

  [Tag Page](https://userguide.qualytics.io/tags/deep-dive/tag-page/)
- **Examples**

  Real scenarios showing how tags focus scores, route alerts, and clean up a tag library.

  [Examples](https://userguide.qualytics.io/tags/deep-dive/examples/)
- **Best Practices**

  Guidelines for a tag library that stays small, consistent, and useful.

  [Best Practices](https://userguide.qualytics.io/tags/deep-dive/best-practices/)
- **Permissions**

  The user roles and team permissions behind creating, applying, and managing tags.

  [Permissions](https://userguide.qualytics.io/tags/deep-dive/permissions/)

---

## How-tos

Step-by-step guides, grouped by what each task changes: the **Tag** guides change the tag in the library, and the **Assets** guides change which assets carry it.

### Tag

- **Add a Tag**

  Create a tag with its scope, color, category, and weight.

  [Add a Tag](https://userguide.qualytics.io/tags/how-tos/tag/add/)
- **Edit a Tag**

  Change a tag's name, color, description, category, weight, or scope.

  [Edit a Tag](https://userguide.qualytics.io/tags/how-tos/tag/edit/)
- **Delete a Tag**

  Remove a tag from the library and from every asset that carries it.

  [Delete a Tag](https://userguide.qualytics.io/tags/how-tos/tag/delete/)
- **Merge Tags**

  Move everything that uses a tag to another tag, then delete it.

  [Merge Tags](https://userguide.qualytics.io/tags/how-tos/tag/merge/)

### Assets

- **Apply a Tag**

  Put a tag on an asset, or on many assets at once.

  [Apply a Tag](https://userguide.qualytics.io/tags/how-tos/assets/apply/)
- **Move a Tag to Another Tag**

  Replace a tag with another one on some or all of its assets.

  [Move a Tag](https://userguide.qualytics.io/tags/how-tos/assets/move/)
- **Remove a Tag from Assets**

  Take a tag off the assets you select, from the tag's page.

  [Remove a Tag](https://userguide.qualytics.io/tags/how-tos/assets/remove-from-assets/)

- **Filter and Sort Tags**

  Search the Tags list and narrow it by type, scope, or category.

  [Filter and Sort Tags](https://userguide.qualytics.io/tags/how-tos/filter-and-sort/)

---

## Reference

The API covers managing tags and acting on their assets programmatically, and the FAQ answers the most common questions.

- **API**

  Create, update, delete, list, move, remove, and merge tags programmatically.

  [API](https://userguide.qualytics.io/tags/api/)
- **FAQ**

  Common questions about inheritance, weights, team tags, and merging.

  [FAQ](https://userguide.qualytics.io/tags/faq/)

*Last updated: November 5, 2026.*
