# Labels

**Labels** in Hivel allow you to tag users with additional metadata that you can later use to filter across various metrics and reporting screens. They’re highly flexible and customizable, helping you organize users beyond just teams or roles.

{% hint style="info" %}
Please note: Labels will be set at an org level and be visible to everyone as filters.
{% endhint %}

***

{% embed url="<https://hivel.storylane.io/share/zqkxwlh00whn>" %}

### What You Can Do with Labels

* Add meaningful tags to users (e.g. `Location: APAC`, `Seniority: Senior`, `Department: Frontend`)
* Assign multiple labels to one or more users
* Group labels into **categories** for better organization
* Filter metrics and insights using these labels

<figure><img src="/files/stIQZjrkRDShVWqaH0Qx" alt="" width="563"><figcaption></figcaption></figure>

***

### 🛠️ How to Set Up Labels

1. **Go to the Labels Screen**
   * Navigate to **Settings → Labels**.
2. **Create a Category (if needed)**
   * All labels must belong to a **category**.
   * Click **"Add Category"** if you don’t already have one.
3. **Add a New Label**

   * Under an existing category, click **“Add Label”**.

   * Enter the label name (e.g. `Contractor`, `Europe`, `Level 2`).

   > **Note:** Labels **must belong to a category** - they cannot exist independently.

   *

   ```
   <figure><img src="/files/Mit2n9I1s3cgP9rBcTnV" alt="" width="375"><figcaption></figcaption></figure>
   ```
4. **Edit or Remove Labels and Categories**
   * Click the ✏️ (pencil) icon to **edit**.
   * Click the ❌ (cross) icon to **delete**.
   * **Deleting a label** will remove it from **all users** it's currently assigned to.

<figure><img src="/files/bUQj4lx9YYWW4ZYYjOzc" alt="" width="310"><figcaption></figcaption></figure>

<figure><img src="/files/IVZFKcPKtB6x4cLEGaEz" alt="" width="375"><figcaption></figcaption></figure>

***

### 👥 Assign Labels to Users

<figure><img src="/files/YDdEZH7shcSVcKo0uebH" alt="" width="224"><figcaption></figcaption></figure>

<figure><img src="/files/bMrmDoYIvVol4eKF88kz" alt="" width="375"><figcaption></figcaption></figure>

1. Go to the **Users** screen.
2. Select one or multiple users.
3. Click the **Labels icon**.
4. Choose the labels to assign and click **Save**.

***

### 🔎 Filtering by Labels

<figure><img src="/files/GQCASeMF85Z2mv6xF7gW" alt=""><figcaption></figcaption></figure>

Once labels are assigned:

* You’ll see **label filters** across Hivel’s metrics and reporting screens.
* These filters act as an **extra layer of user segmentation**, making it easier to analyze specific cohorts.

***

### 🧩 Example Use Cases

| Category   | Labels                 |
| ---------- | ---------------------- |
| Location   | APAC, EMEA, NA         |
| Department | Frontend, Backend, QA  |
| Seniority  | Junior, Mid, Senior    |
| Employment | Full-time, Contractor  |
| Onboarding | Completed, In Progress |


---

# 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.hivel.ai/set-up/labels.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.