# JIRA

:::info
This integration is available in all editions from **v1.8.0** onwards

:::

The JIRA integration allows previews of issues in JIRA within Outline. For example, hovering over a JIRA mention will show a preview of the issue status at that url.

# Setup


1. [Register a new “OAuth 2.0 Integration”](https://developer.atlassian.com/console/myapps), you’ll need to fill out the following fields:

* **Name** – “Outline” might make sense
* **Permissions** – Choose the following 3 scopes:
  * User Identity API: `read:me`
  * JIRA API: `read:jira-work`, `read:jira-user` 
* **Authorization** – Add “OAuth 2.0”, under callback URL use `<yourdomain.com>/api/jira.callback`
* **Settings** – Record the Client ID and Secret



2. Add the configuration to the Outline environment, using the following variable names:

   ```javascript
   JIRA_CLIENT_ID=
   JIRA_CLIENT_SECRET=
   ```
3. Restart the server, you should see “JIRA” available under **Settings → Integrations**

---

**Documents**

- [License restrictions](https://docs.getoutline.com/s/hosting/doc/license-restrictions-f9aq6uEL3H)
- [Requirements](https://docs.getoutline.com/s/hosting/doc/requirements-ULdYnwi4wG)
- [Installation methods](https://docs.getoutline.com/s/hosting/doc/installation-methods-pSvgz9j0QC)
- [Configuration](https://docs.getoutline.com/s/hosting/doc/configuration-509J4lAzjo)
- [Business + Enterprise](https://docs.getoutline.com/s/hosting/doc/business-enterprise-rv0715NxO3)
- [Backups](https://docs.getoutline.com/s/hosting/doc/backups-KZtPOADCHG)
- [Troubleshooting](https://docs.getoutline.com/s/hosting/doc/troubleshooting-HXckrzCqDJ)