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

# Labels

> Mark and organize tickets with custom labels

Labels provide a flexible way to organize tickets beyond the standard attributes. Use labels to tag tickets by request area, department, location, or any custom grouping your team needs.

***

## How Labels Work

Labels are colored tags that you can apply to tickets for:

* **Grouping** - Group related tickets (e.g., "Billing", "Feature Request", "Bug")
* **Filtering** - Quickly find tickets with specific labels
* **Reporting** - Analyze ticket volume by label
* **Visual identification** - Spot ticket types at a glance in list view

***

## Applying Labels

### From the Ticket List

Click the labels column on any ticket to add or remove labels:

1. Click the **Labels** area on the ticket row
2. Select labels from the dropdown
3. Click away to save

<Tip>
  You can apply multiple labels to a single ticket.
</Tip>

### From the Ticket Detail

Open a ticket and use the labels field in the right panel:

***

## Creating Labels

Admins can create new labels in team settings:

<Steps>
  <Step title="Open team settings">
    Navigate to **Settings** for your team.
  </Step>

  <Step title="Navigate to Labels">
    Go to the **Labels** section.
  </Step>

  <Step title="Add a new label">
    Click **Add Label** and configure:

    * **Name** - Short, descriptive name
    * **Color** - Choose a color for visual identification
    * **Description** - Explain when to use this label
  </Step>

  <Step title="Save">
    Click **Create** to make the label available.
  </Step>
</Steps>

***

## Label Best Practices

<CardGroup cols={2}>
  <Card title="Keep it simple" icon="minimize">
    Start with a small set of labels. You can always add more as needs emerge.
  </Card>

  <Card title="Use consistent naming" icon="text">
    Establish naming conventions (e.g., lowercase, no spaces) for easy searching.
  </Card>

  <Card title="Color code by labels" icon="palette">
    Use similar colors for related labels (e.g., all product areas in blue shades).
  </Card>

  <Card title="Document usage" icon="book">
    Add clear descriptions so team members know when to apply each label.
  </Card>
</CardGroup>

### Common Label Values

<AccordionGroup>
  <Accordion title="Request Area">
    * Access
    * Hardware
    * Software
    * Networking
    * Onboarding
  </Accordion>

  <Accordion title="Department">
    * IT
    * HR
    * Facilities
    * Finance
    * Security
  </Accordion>

  <Accordion title="Location">
    * HQ
    * Remote
    * NYC Office
    * SF Office
  </Accordion>

  <Accordion title="Urgency Context">
    * New Hire
    * VIP
    * Executive
    * Audit-Related
  </Accordion>
</AccordionGroup>

***

## Filtering by Labels

Use labels to filter your ticket list:

1. Click the **Filter** button
2. Select **Labels**
3. Choose one or more labels to filter by

<Note>
  When filtering by multiple labels, tickets matching **any** of the selected labels are shown.
</Note>
