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

# Categories

> Define and assign ticket categories to classify requests manually or with AI

Categories allow you to define the different kinds of requests your team handles. You can set a ticket's category at any time from the Serval UI. If a ticket does not have a category set, Serval can also automatically classify it on escalation.

***

## How Categories Are Set

There are two ways a ticket gets a category:

1. **Manually** — You can set or change a ticket's category from the ticket side panel at any time.
2. **Automatically on escalation** — When a ticket is escalated to a human agent, Serval reads the ticket content and assigns the most appropriate category from your configured list. Serval will not override a category you have already set manually.

Categories are used for:

* **Ticket assignment** — [Assignment rules](/sections/documentation/ticketing/ticket-configuration/assignment) use categories as one of several conditions to determine ticket assignment

<Steps>
  <Step title="Open category settings">
    Go to **Team Settings** → **Categories**
  </Step>

  <Step title="Add a category">
    Click **New Category** and provide a name and description. The description helps Serval's AI accurately match tickets, so be specific about what kinds of requests belong in each category.
  </Step>
</Steps>

<Tip>
  Think about how your team naturally segments incoming requests. Common patterns include segmenting by topic.
</Tip>

### Example Categories

| Category                         | Description                                                                           |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| **Billing and Finance**          | Questions about invoices, payments, refunds, pricing, or subscription changes         |
| **Design Apps Access**           | Access requests for design tools like Figma, Sketch, or Adobe Creative Cloud          |
| **Device Issues**                | Laptop problems, peripheral malfunctions, hardware troubleshooting, equipment repairs |
| **Password Reset Requests**      | Password resets, account lockouts, credential recovery                                |
| **Onboarding Processes**         | New hire setup, orientation questions, first-day logistics                            |
| **Device and Computer Requests** | New laptop orders, monitor requests, equipment returns, device upgrades               |

***

## Managing Categories

### Editing Categories

Category names and descriptions can be created and updated on the Categories tab.

### Deleting Categories

When you delete a category, any assignment rules that use it as a condition may be affected. You'll see a confirmation warning before the deletion goes through.

<Warning>
  Deleting a category may affect assignment rules that use it as a condition.
</Warning>

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Make categories disjoint" icon="shield">
    Create categories that are sufficiently different from one another to avoid confusion.
  </Card>

  <Card title="Write descriptive names and descriptions" icon="pencil">
    Include specific keywords and examples in your category descriptions. This helps Serval accurately infer the category from ticket content.
  </Card>

  <Card title="Match categories to subject-matter expertise" icon="bullseye">
    Align categories to your team's areas of expertise so they pair naturally with assignment rules.
  </Card>

  <Card title="Review and iterate" icon="arrows-rotate">
    Periodically check whether tickets are landing in the right categories. Adjust descriptions or add new categories as request patterns evolve.
  </Card>
</CardGroup>

***

## Viewing and Changing a Ticket's Category

A ticket's category is displayed in the ticket side panel under **Properties**. You can click on the category to change it or select **No category** to clear it.

<Frame caption="The ticket side panel showing the category selector">
  <img src="https://mintcdn.com/serval/1MkNvweOjUDMFgE8/images/category-sidepanel.png?fit=max&auto=format&n=1MkNvweOjUDMFgE8&q=85&s=453abba556ff9e2a89de95549cdb2890" alt="Ticket side panel displaying the category selector" style={{ maxWidth: '400px' }} width="750" height="1046" data-path="images/category-sidepanel.png" />
</Frame>

### Ticket Activity

Category changes are logged in each ticket's activity section, whether set manually or by Serval.

<Frame caption="Category change event in the activity feed">
  <img src="https://mintcdn.com/serval/1MkNvweOjUDMFgE8/images/category-activity.png?fit=max&auto=format&n=1MkNvweOjUDMFgE8&q=85&s=036d9187e532c5c20dc38af1ff7a9a4d" alt="Ticket activity feed showing a category change event" width="1364" height="310" data-path="images/category-activity.png" />
</Frame>

***

## Related

<CardGroup cols={2}>
  <Card title="Assignment Rules" icon="route" href="/sections/documentation/ticketing/ticket-configuration/assignment">
    Use categories as conditions in assignment rules for automatic ticket assignment
  </Card>

  <Card title="Labels" icon="tags" href="/sections/documentation/ticketing/ticket-configuration/labels">
    Add flexible tags to tickets for filtering and reporting
  </Card>
</CardGroup>
