Skip to main content
New Feature Categories is currently rolling out to organizations. If you don’t see it yet, it will be available soon. Want early access? Contact us to discuss enabling it for your organization.
Categories use AI-powered classification to automatically organize tickets when they’re created, analyzing ticket content to determine the best classification match.

​
Understanding Categories

Categories automatically classify tickets based on the criteria you define. Each category includes:
  • Name: The category label shown on tickets
  • Description: Explains what types of tickets belong in this category
  • Examples: Sample phrases that help AI classify tickets accurately
Category settings page showing list of categories

​
Categories vs Tags

While both help organize tickets, they serve different purposes:
FeatureCategoriesTags
AssignmentAutomatic via AIManual, AI-assisted, or workflow-based
PurposePrimary classificationFlexible labeling
LimitOne per ticketMultiple per ticket
Examples”Password Reset”, “Hardware Issue""Urgent”, “VIP”, “Needs Review”
Many teams find success using categories for primary classification and tags for additional context like priority, status, or team assignments.

​
Setting Up Categories

​
Creating Categories

Navigate to Settings > Workspaces > Categories to create categories for your workspace.
Create category form showing name, description, and examples fields
Each category requires:
  1. Name (required): Clear, descriptive label like “Password Reset” or “Software Request”
  2. Description (optional): Explains what belongs in this category - “Requests to reset user passwords or unlock accounts”
  3. Examples (required): Sample phrases that represent this category:
    • “I forgot my password”
    • “Can’t log into my account”
    • “Need to reset my credentials”

​
Using Templates

Save time by importing pre-built category sets for common use cases. Templates provide ready-to-use categories with names, descriptions, examples, icons, and colors already configured.
Category template browser showing IT Support, HR, and Facilities categories
To use templates:
  1. Navigate to Settings > Workspaces > Categories
  2. Click New from template
  3. Browse categories organized by department (IT Support, HR, Facilities, etc.)
  4. Select multiple categories to import
  5. Click Create to add them to your workspace
You can select up to 100 categories at once when importing from templates. After import, customize any category to match your team’s specific needs.

​
Editing Categories

You can modify category details at any time:
  • Name and description
  • Example phrases
  • Default category status
Changes to examples and descriptions will affect future AI classifications but won’t reclassify existing tickets.

​
Default Category

Every workspace requires exactly one default category. You can manually assign the default category to tickets that don’t fit into other categories.
The first category you create automatically becomes the default category. You can change this later by editing another category and marking it as default.
To change the default category:
  1. Edit the category you want to make default
  2. Toggle Set as default to enabled
  3. Save changes
The previous default category is automatically unset when you assign a new one.

​
Deleting Categories

You can delete categories that are no longer needed:
  1. Navigate to Settings > Workspaces > Categories
  2. Select the category to delete
  3. Click Delete
  • You cannot delete the default category
  • Tickets assigned to deleted categories will show “No category” until manually updated

​
How Classification Works

When a ticket is created, Ravenna automatically analyzes its content and assigns the most appropriate category by examining the ticket’s title, description, and initial messages against your category descriptions and example phrases.
If AI can’t find a good match, the ticket remains unclassified (no category assigned). You can manually assign a category anytime, including your default category for tickets that don’t fit elsewhere.
Auto-classification only runs when tickets are first created and don’t already have a category assigned. This means:
  • Categories you manually set during ticket creation won’t be overwritten
  • Categories assigned by workflows stay as you configured them
  • You can always manually change a category without AI changing it back

​
Using Categories

​
Viewing and Assigning Categories

Categories appear on tickets in multiple places:
  • Ticket Detail: Category badge displayed in ticket attributes
  • Ticket List: Category shown as a filterable column
  • Analytics: Category-based reporting and grouping
While categories are typically assigned automatically, you can manually set or change a ticket’s category:
  1. Open the ticket
  2. Click the category field in ticket attributes
  3. Select a different category from the dropdown
Manual assignments take precedence over auto-classification. The AI will not overwrite categories you’ve manually set.

​
Filtering and Analytics

Use categories to filter your ticket list and focus on specific topics: Category filters work in:
  • Ticket list views
  • Saved filters and views
  • Analytics dashboards
Categories enable powerful reporting capabilities: View category-based metrics for:
  • Ticket volume by category
  • Resolution time by topic
  • Category trends over time
  • Team workload by category type

​
With Agent Rules

Categories can be referenced in agent Rules to create conditional logic and automation based on ticket topics. Use @ mentions to reference categories in agent Rule instructions. For example: 
When a ticket with category @Password Reset is created,
set the priority to URGENT
When you mention a category in a Rule, the agent gains access to that category’s details (name, description, examples) as reference context. This helps the agent understand ticket topics and apply appropriate logic. Common patterns:
  • Auto-escalate specific categories: “When @Security Issue tickets are created, assign to Security Team”
  • Set priorities by topic: “For @Hardware Failure tickets, set priority to HIGH”
  • Conditional workflows: “If category is @Software Request, run approval workflow”

​
Best Practices

​
Writing Effective Categories

Good category descriptions help AI classify tickets accurately:
  • Be specific: “Password reset requests for user accounts”
  • Include context: “Hardware issues including laptops, monitors, and peripherals”
  • Use clear language: “Software installation and license requests”
  • Avoid overlap: Keep categories distinct from each other
Example phrases train the AI. Include 5-10 diverse examples using natural language that matches how your users actually describe issues:
  • ✅ “I can’t access my email”
  • ✅ “Locked out of my account”
  • ✅ “Need to reset my password”
  • ❌ “password” (too generic)
  • ❌ “authentication failure” (too technical)

​
Organizing Your Categories

  • Start small: Begin with 5-10 core categories. You can always add more later.
  • Avoid overlap: Keep categories distinct. “Password Issues” and “Login Problems” overlap - combine them instead.
  • Review regularly: Check tickets in your default category to spot patterns that need their own category.
  • Test and adjust: Monitor classification accuracy in the first week and refine examples as needed.

​
Categories vs Tags

Many teams use both: categories for the primary topic (Password Reset, Hardware Issue) and tags for additional context like team ownership or urgency (IT Team, High Priority).

​
Common Questions

No, each ticket can only have one category assigned. This ensures clear primary classification. Use tags if you need additional labels.
The ticket is automatically assigned to your workspace’s default category (typically “Other” or “Uncategorized”). You can manually change it later.
No, classification only runs when tickets are created. To update existing tickets, manually change their categories or use bulk actions.
Add more diverse example phrases that match how your users actually describe issues. Check tickets in your default category to spot misclassifications and adjust examples accordingly.
Not directly, but you can use category templates which provide pre-configured categories. If you’ve customized categories in one workspace, you’ll need to recreate them manually in others.
Yes, tickets created from integrations (Linear, Jira, Notion) are classified the same way as tickets from other sources. The category exists only in Ravenna - it doesn’t sync back to the integration.