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

# Jira

> Set up bidirectional sync between Rootly incidents and Jira issues with field mapping, automated ticket creation, status updates, and custom workflows.

Rootly's Jira integration keeps incidents and Jira issues in sync. When an incident is declared, a Jira issue is automatically created. Updates flow both ways: incident changes update Jira, and Jira changes can update incidents.

<CardGroup cols={2}>
  <Card title="Smart Defaults" icon="bolt">
    Auto-create Jira issues at incident start without building workflows
  </Card>

  <Card title="Custom Workflows" icon="diagram-project">
    Advanced automation with triggers, conditions, and multiple actions
  </Card>

  <Card title="Field Mapping" icon="table-columns">
    Map incident data to Jira native and custom fields
  </Card>

  <Card title="Action Items → Subtasks" icon="list-tree">
    Follow-up tasks become Jira subtasks linked to the parent issue
  </Card>
</CardGroup>

***

## How It Works

<Steps>
  <Step title="Connect Jira">
    Authenticate via OAuth and configure webhooks for bidirectional sync.
  </Step>

  <Step title="Configure Automation">
    Use Smart Defaults for instant setup, or build custom workflows for conditional logic.
  </Step>

  <Step title="Incident Declared">
    When an incident is created, Rootly automatically creates a Jira issue.
  </Step>

  <Step title="Updates Flow Both Ways">
    Changes to incidents update Jira. Jira events can trigger incident updates.
  </Step>
</Steps>

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Installation" icon="plug" href="/integrations/jira/installation">
    Connect Jira and set up webhooks
  </Card>

  <Card title="Workflows" icon="diagram-project" href="/integrations/jira/workflows">
    Configure Smart Defaults and custom workflows
  </Card>

  <Card title="Jira → Rootly" icon="arrow-left" href="/integrations/jira/jira-to-rootly-sync">
    Create incidents from Jira events
  </Card>
</CardGroup>