> 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).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.runway.team/integrations/incident-management-and-scheduling/jira-service-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.