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

# Priorities

> Use Ravenna's four ticket priority levels to organize work by urgency, prioritize the queue, and surface the right requests for your team first.

Priorities help your team organize and manage tickets based on their urgency and importance. Use four priority levels to ensure the right tickets get attention at the right time.

<View title="Human" icon="user">
  ***

  ## Priority levels

  Ravenna provides five priority levels to categorize tickets:

  <AccordionGroup>
    <Accordion title="No priority" icon={<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16" className="text-muted-foreground h-3.5 w-3.5 mr-1 flex-none"><path fill="#737373" fillOpacity="0.25" d="M13 2h-1a1 1 0 0 0-1 1v10a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V3a1 1 0 0 0-1-1M3 8H2a1 1 0 0 0-1 1v4a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V9a1 1 0 0 0-1-1M8 5H7a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1"></path></svg>} defaultOpen>
      Tickets that have not been assigned a priority level. These tickets should be reviewed and assigned an appropriate priority.
    </Accordion>

    <Accordion title="Low" icon={<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16" className="text-muted-foreground h-3.5 w-3.5 mr-1 flex-none"><path fill="#737373" fillOpacity="0.25" d="M13 2h-1a1 1 0 0 0-1 1v10a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V3a1 1 0 0 0-1-1"></path><path fill="#737373" d="M3 8H2a1 1 0 0 0-1 1v4a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V9a1 1 0 0 0-1-1"></path><path fill="#737373" fillOpacity="0.25" d="M8 5H7a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1"></path></svg>}>
      Nice-to-have features, minor improvements, or issues that don't significantly impact users. These can be addressed when time permits.
    </Accordion>

    <Accordion title="Medium" icon={<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16" className="text-muted-foreground h-3.5 w-3.5 mr-1 flex-none"><path fill="#737373" fillOpacity="0.25" d="M13 2h-1a1 1 0 0 0-1 1v10a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V3a1 1 0 0 0-1-1"></path><path fill="#737373" d="M3 8H2a1 1 0 0 0-1 1v4a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V9a1 1 0 0 0-1-1M8 5H7a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1"></path></svg>}>
      Standard priority for most tickets. These are routine requests, non-critical bugs, or general support issues that can be handled in the normal workflow.
    </Accordion>

    <Accordion title="High" icon={<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16" className="text-muted-foreground h-3.5 w-3.5 mr-1 flex-none"><path fill="#737373" d="M13 2h-1a1 1 0 0 0-1 1v10a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V3a1 1 0 0 0-1-1M3 8H2a1 1 0 0 0-1 1v4a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V9a1 1 0 0 0-1-1M8 5H7a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h1a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1"></path></svg>}>
      Important issues that should be addressed soon but aren't blocking critical operations. These might include time-sensitive requests or issues affecting key processes.
    </Accordion>

    <Accordion title="Urgent" icon={<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16" className="text-muted-foreground h-3.5 w-3.5 mr-1 flex-none"><path stroke="#F97316" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1.25" d="M13.676 11.5 9.009 3.334a1.167 1.167 0 0 0-2.03 0L2.313 11.5a1.167 1.167 0 0 0 1.02 1.75h9.334a1.167 1.167 0 0 0 1.009-1.75M8 6.25v2.333M8 10.917h.005"></path></svg>}>
      Critical issues that require immediate attention. These are typically system outages, security incidents, or blocking issues that affect multiple users.
    </Accordion>
  </AccordionGroup>

  ***

  ## Set priorities

  Priorities can be assigned in several ways:

  <AccordionGroup>
    <Accordion title="During ticket creation" icon="plus" defaultOpen>
      When creating a ticket, select the priority from the form field. The default priority is Medium unless configured differently on the <Tooltip headline="Forms" tip="Structured intake forms with custom fields" cta="Learn about forms" href="/documentation/tickets/forms/overview">form</Tooltip>.
    </Accordion>

    <Accordion title="Manual updates" icon="pencil">
      Team members with appropriate permissions can update ticket priority at any time by clicking the priority field in ticket attributes and selecting a new level.
    </Accordion>

    <Accordion title="Bulk operations" icon="layers">
      Select multiple tickets from the ticket list and use bulk actions to update their priorities simultaneously.
    </Accordion>

    <Accordion title="Workflow automation" icon="workflow">
      Configure <Tooltip headline="Workflows" tip="Automated actions triggered by ticket events" cta="Learn about workflows" href="/documentation/automate/workflows/overview">workflows</Tooltip> to automatically set or escalate priorities based on ticket content, conditions, or events.
    </Accordion>

    <Accordion title="AI agent rules" icon="bot">
      Set up <Tooltip headline="AI agent rules" tip="Conditional logic and automation for AI agents" cta="Learn about agent rules" href="/documentation/automate/ai-agents/configure-agents">agent rules</Tooltip> to automatically assign priorities based on ticket content analysis.
    </Accordion>
  </AccordionGroup>

  <Info>
    Priority is a required field. All tickets must have a priority assigned. The default priority is Medium unless customized in form settings.
  </Info>

  ***

  ## Configure default priorities

  Each <Tooltip headline="Forms" tip="Structured intake forms with custom fields" cta="Learn about forms" href="/documentation/tickets/forms/overview">form</Tooltip> can have its own default priority to ensure consistent prioritization across similar ticket types.

  <Steps>
    <Step title="Navigate to forms">
      Go to **Settings > Forms** to configure default priorities.
    </Step>

    <Step title="Select form">
      Choose the specific form you want to configure.
    </Step>

    <Step title="Open settings">
      Click **Settings** for the selected form.
    </Step>

    <Step title="Access defaults">
      Navigate to the **Defaults** section within the form settings.
    </Step>

    <Step title="Set default priority">
      Choose the appropriate default priority level for tickets created with this form.
    </Step>

    <Step title="Save changes">
      Click **Save** to apply the new default priority setting.
    </Step>
  </Steps>

  **Example:** Set "Bug Report" forms to default to High priority, while "Feature Request" forms default to Low priority.

  ***

  ## Use priorities

  ### Filter and sort

  Use priorities to organize your ticket list:

  **Filtering**

  * Filter <Tooltip headline="Views" tip="Saved filters and column configurations for organizing tickets" cta="Learn about views" href="/documentation/tickets/organize/views">views</Tooltip> to show only specific priority levels
  * Create saved filters for quick access to high-priority tickets
  * Use priority filters in dashboards and reports

  **Sorting and grouping**

  * Sort tickets by priority (Urgent → Low or Low → Urgent)
  * Group tickets by priority in list views and Kanban boards
  * Organize Kanban boards with priority-based columns

  Priority is displayed as both text labels and colored badges for easy identification.

  ### Workflows

  Use priorities in <Tooltip headline="Workflow" tip="Automated actions triggered by ticket events" cta="Learn about workflows" href="/documentation/automate/workflows/overview">workflow</Tooltip> conditions and actions:

  **Triggers**

  * Trigger workflows when tickets are assigned specific priorities
  * Create escalation workflows for urgent tickets
  * Set up notifications for high-priority ticket creation

  **Actions**

  * Automatically set priorities based on ticket content
  * Escalate priorities when tickets remain unresolved
  * Send priority-based notifications to different team members

  **Conditional logic**

  * Use priority as a condition in workflow rules
  * Create different approval processes for different priority levels
  * Route tickets based on priority and other criteria

  <Callout icon="link" color="#6B7280">
    Learn more about [building workflows](/documentation/automate/workflows/publish) with priority conditions
  </Callout>

  ### Analytics

  Use priorities in your <Tooltip headline="Analytics" tip="Reports and metrics for tracking ticket performance" cta="Learn about analytics" href="/documentation/measure/analytics">analytics</Tooltip> and reporting:

  * Track ticket volume by priority level
  * Monitor resolution times across different priorities
  * Analyze team performance on high-priority tickets
  * Identify priority trends over time
  * Review priority changes in ticket event history and activity logs
</View>

<View title="Agent" icon="bot">
  ## Mental model

  Priority is a built-in ticket property with a fixed set of five levels: none, low, medium, high, urgent. Every ticket has exactly one priority. The default is medium unless a form specifies a different default.

  Priority is distinct from categories and tags:

  * **Priority** is a single fixed-enum property on every ticket. It represents urgency/importance.
  * **Categories** are AI-assigned topic labels (one per ticket).
  * **Tags** are freeform multi-labels for supplementary metadata.

  Priority is also distinct from SLAs. SLAs define response and resolution time targets, which can be configured per priority level, but they are separate features.

  ***

  ## Priority assignment patterns

  | Method            | When to use                                                                                                                                                    |
  | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | **Form defaults** | Set per-form defaults so tickets from specific forms start at the right priority (e.g., "Incident Report" defaults to high, "Feature Request" defaults to low) |
  | **Agent rules**   | Have the agent assess urgency from conversation context and set priority accordingly                                                                           |
  | **Workflows**     | Auto-set priority based on ticket properties (e.g., set to urgent when a specific category is assigned, escalate priority after SLA breach)                    |
  | **Manual**        | User or agent sets priority during or after ticket creation                                                                                                    |

  For most workspaces, form defaults handle the majority of cases. Agent rules and workflows handle the exceptions and escalations.

  ***

  ## Using priority in automation

  **Agent rules:** The agent can set priority based on conversation analysis. Common patterns:

  * "If the user reports a system outage affecting multiple people, set priority to urgent."
  * "For password reset requests, set priority to medium."
  * "If the user mentions they are blocked from working, set priority to high."

  **Workflow triggers:** Priority changes can trigger workflows. The "Ticket Updated" trigger with a priority filter lets you build escalation automations.

  **Workflow conditions:** Use priority as a branching condition in workflows. For example: if priority is urgent, notify the on-call channel and assign to the team lead. If priority is low, add to the backlog queue.

  **Escalation pattern:** Combine priority with time-based triggers. If a high-priority ticket is not resolved within a set time, a workflow can escalate it to urgent, reassign it, or notify management.

  ***

  ## Constraints and gotchas

  * Priority levels are fixed (none, low, medium, high, urgent). You cannot add, remove, or rename priority levels.
  * Priority is a required field. Every ticket has a priority, even if it is "none" (which represents unset).
  * The system-wide default priority is medium. This can be overridden per form but not globally.
  * Priority does not automatically affect SLA targets. SLAs can be configured to vary by priority, but changing a ticket's priority does not retroactively adjust SLA deadlines already set.
  * Priority does not sync bidirectionally with external integrations. If a ticket is replicated to Jira, the priority in Ravenna and the priority in Jira are independent unless a workflow explicitly maps them.
</View>
