--- title: Integrate Jira with Datadog Incident Management description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: >- Docs > Incident Response > Incident Management > Setup and Configuration > Incident Integrations > Integrate Jira with Datadog Incident Management --- # Integrate Jira with Datadog Incident Management ## Overview{% #overview %} Jira is a work item and project tracking system for software teams. The Datadog Jira integration allows you to create Jira work items from Datadog incidents and sync data between the two platforms. The Jira integration with Datadog Incident Management provides the following benefits: - **Improved Visibility**: Ensure that all stakeholders are immediately informed about incidents, facilitating a quicker response. - **Supporting Existing Workflows**: Integrate with your current processes, making it easier to plan work and manage priorities in Jira. - **Flexible Mapping and Configuration**: With dynamic templates, you can map Datadog severities to Jira priorities, map incident statuses to Jira statuses, add custom labels, and define dynamic assignees. - **Bidirectional Sync**: Teams can collaborate across Datadog and Jira simultaneously. When fields are configured for two-way sync, changes made in either platform are automatically reflected in the other. ## Prerequisites{% #prerequisites %} To use automatic work item creation, install the integration through the [Jira Integration tile](https://app.datadoghq.com/integrations/jira). For more information, see the [Jira integration](https://docs.datadoghq.com/integrations/jira.md) documentation. To enable bidirectional sync, you must also configure a Jira webhook. See [Configure a Jira webhook](https://docs.datadoghq.com/integrations/jira.md#configure-a-jira-webhook) for instructions. ## Setup{% #setup %} ### Configuring Jira work item creation{% #configuring-jira-work-item-creation %} 1. On the [Integration Settings page](https://app.datadoghq.com/incidents/settings?integration=jira§ion=integrations), find the Jira integration. 1. Enable the **Automatically create a parent work item** toggle. 1. Select your Jira account, project, and work item type. 1. Optionally, add a condition to define when to automatically create a Jira work item. If left blank, a Jira work item is created for all new incidents. ### Configuring bidirectional sync{% #configuring-bidirectional-sync %} To sync fields between an incident and its linked Jira work item, enable the **Sync Data Between Incident Management and Jira** toggle. When enabled, a field configuration table appears. {% alert level="danger" %} To enable bidirectional sync, you must configure a Jira webhook. See [Configure a Jira webhook](https://docs.datadoghq.com/integrations/jira.md#configure-a-jira-webhook) for instructions. {% /alert %} {% image source="https://docs.dd-static.net/images/incident_response/incident_management/integrations/sync_between_incident_jira.dd462a89eb0424c68f671d7d2f788ca0.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/incident_response/incident_management/integrations/sync_between_incident_jira.dd462a89eb0424c68f671d7d2f788ca0.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Field configuration table for syncing between Datadog Incident Management and Jira" /%} For each field you want to sync, configure the following: - **Jira field**: The Jira field to populate. You can use any standard or custom Jira field. - **Incident field or custom value**: Select a pre-populated incident field (such as **Incident Title** or **Incident Commander**), or enter a custom value using `{{` to insert incident template variables. Dynamic variables work only with **string** [Jira field types](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field-type). - **Sync direction**: Choose **One-way sync** (Datadog to Jira only) or **Two-way sync** (bidirectional) for each field independently. Bidirectional sync supports **string**, **number**, and **date/datetime** [Jira field types](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field-type). To add fields beyond the defaults, click **Add custom field** and select a Jira field from the dropdown. {% collapsible-section %} #### Sync comments To sync comments between the Datadog incident timeline and Jira, add **Comments** as a custom field. When set to **Two-way sync**, Jira comments appear as incident timeline entries, and incident timeline entries appear as Jira comments. {% /collapsible-section %} {% collapsible-section %} #### Status and severity mappings Configure status and severity mappings to translate incident states and severities to Jira statuses and priorities. Each mapping can be set to **One-way sync** or **Two-way sync** independently. {% /collapsible-section %} ### Manually link additional work items{% #manually-link-additional-work-items %} In addition to the automatically created parent work item, you can manually link additional Jira work items to an incident. These manually linked items appear alongside the auto-created work item in the incident view. Manually created Jira work items are not synced with the incident. ### Save your settings{% #save-your-settings %} When you save changes to the configuration of an incident type that already has active incidents, the changes apply only to future incidents. Existing incidents are not updated retroactively. ## Further Reading{% #further-reading %} - [Install the Jira Integration](https://docs.datadoghq.com/integrations/jira.md) - [In-app Jira integration tile](https://app.datadoghq.com/integrations/jira) - [Export follow-ups to Jira](https://docs.datadoghq.com/incident_response/incident_management/post_incident/follow-ups.md)