> For the complete documentation index, see [llms.txt](https://docs.runway.team/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.runway.team/integrations/incident-management-and-scheduling/jira-service-management.md).

# Jira Service Management

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

{% hint style="warning" %}
Jira Service Management requires a Jira integration to be connected first from the Project Management integrations section.
{% endhint %}

### **Connect Jira Service Management**

1. Find the **Jira Service Management** integration module under the **Scheduling** section.
2. Click the **Connect** button.
3. You will be prompted to login to Atlassian and provide read access to Runway. 

{% hint style="warning" %}
Your Jira Service Management account must grant the following access rights in order to work properly with Runway:

* Read configuration of operations including contacts, custom user roles, escalations, forwarding rules, heartbeats, integrations, maintenances, notification rules, routing rules, schedules, on-calls, and syncs.
  {% endhint %}

### Configure the Jira Service Management integration

1. Choose a **Schedule** and **Rotation** from the dropdown that will be used to assign release pilots to releases in Runway.

Release pilots will first be assigned to releases in Runway by matching up *target kickoff dates* to shifts in the configured Schedule and Rotation in Jira Service Management. The user that's scheduled to be on-call on the target kickoff date of a given release will be assigned as release pilot when the release is created.

{% hint style="warning" %}
You will not be able to re-assign or override release pilots in Runway if a Scheduling integration is connected. You must manage release pilots and overrides from Jira Service Management directly.
{% endhint %}

For more details on how the Scheduling integration affects the release pilot rotation in Runway, visit the [Release pilot rotation docs](/using-runway/app-settings/release-pilot-rotation.md#using-a-scheduling-integration-to-manage-the-release-pilot-rotation).