> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags & tagging rules

> Label products and variants — manually or automatically — to drive alerts, workflows, and analysis.

A **tag** is a label you attach to entities (products, variants, brands, inventory
items). Tags power filtering across the app — most importantly in
[alerts](/en/signals/alerts) and [workflows](/en/automation/workflows).

<Note>
  For the **exhaustive, field-level** reference — the condition model, every operator,
  scope & propagation, and the evaluation-run model — see
  [Tagging rules (reference)](/en/developers/tagging-rules/overview).
</Note>

## Kinds of tag

* **Data** — assigned automatically by tagging rules.
* **Business** — assigned manually as a classification.
* **Mixed** — both.

Tags can be applied to **products, brands, variants, or inventory items**.

## Tagging rules

A **tagging rule** assigns or removes a tag automatically based on conditions evaluated
against your analytics data:

* **Metric conditions** — a threshold on a metric (e.g. inventory turnover rate >
  some value), using the same operators as alerts (including top/bottom percent).
* **Column conditions** — a test on a gold/silver column, with type-aware operators:
  * **Text** — equals, contains, starts/ends with, matches regex, is empty…
  * **Date** — before, after, between, on date…
  * **Boolean** — is true / is false.
  * **Numeric** — lower/greater than, equal…

Conditions are combined with **AND** / **OR**. A rule also has a **scope** (entity type +
brand/product/taxonomy/collection filters) and a **propagation mode**: apply to the
matched entity only, **cascade down** to its children, or **bubble up** to its parents.

Tag assignment workflow:

```mermaid theme={null}
flowchart TB
  A["Entities"] -->|Tagging Rules Evaluate| B["Conditions<br/>(Metric / Column)"]
  B -->|Match| C["Tag Assigned"]
  C -->|Tag Evaluation Run| D["Assignments Created/<br/>Removed"]
```

## Evaluation runs

Tags are applied by a **tag evaluation run** (manual, scheduled, or via API). A run
evaluates active rules, **creates** assignments for newly matching entities, **removes**
assignments that no longer match, and records stats and logs.

## Working with tags

<Steps>
  <Step title="Open Tags">
    Go to **Data platform → Tags**.
  </Step>

  <Step title="Create tags and rules">
    Create a tag, then (optionally) a tagging rule with its conditions, scope, and
    propagation.
  </Step>

  <Step title="Run evaluation">
    Trigger a tag evaluation run to apply rules; assignments update automatically on
    later runs.
  </Step>

  <Step title="Use them">
    Filter alerts and workflow triggers by tag.
  </Step>
</Steps>
