# GitHub Issues

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjFmyReUsbJqDjHEAlW%2F-MjH7SeMEkuedQqH2j3U%2F-MjH7sQqcDycHAdAvBKZ%2Fgithub.png?alt=media&#x26;token=83ae9d71-08c1-4563-aad5-256e34756b3c" alt=""></div>

## Set up

### 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

### **Connect GitHub**

* Find the **GitHub** integration module under the **Version control** section
* Click the **Connect** button
* You’ll be taken through a standard [GitHub app](https://developer.github.com/apps/) OAuth flow
  * Select one or more repos to grant access to

{% hint style="warning" %}
You must be logged in as a GitHub user with **admin** permissions in selected repo, or as an **owner** in the GitHub org.
{% endhint %}

* GitHub redirects you back to Runway
  * If you granted access to more than one repo, Runway will present you with a dropdown to select a specific repo

### Add feature affiliations

* Specify the labels and/or milestones that Runway should use associate tickets with specific releases
* Pattern is tokenized with the release version, *e.g.* `ios-{version}`