> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/set-up/labels.md).

# 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 |