--- title: Integrate Jira slug: web-experimentation/docs/configure-jira docTags: createdAt: 2026-07-23T11:40:24.851Z --- :::hint{type="info"} This is a third-party integration and is not an Optimizely subprocessor. See Optimizely's [Third-Party Add-Ons & Platform Integration Terms](https://www.optimizely.com/legal/third-party-add-ons-platform-integration-terms/). ::: Relevant products - Optimizely Web Experimentation - Optimizely Performance Edge Many Web Experimentation customers also manage the development of features and experiments within Jira. This integration lets you connect your Optimizely and Jira workflows without unnecessary duplication of effort by linking Jira issues to Optimizely. Natively link Optimizely experiments to Jira issues. Then track their status directly from the relevant Jira ticket. :::hint{type="info"} **📘 Note** [Optimizely Performance Edge](docId\:D04S8zNQleHpUz5NIP3TL) is a lightweight experimentation product that delivers significantly faster performance than previous versions of Optimizely Web Experimentation. It does this by relying on a streamlined "microsnippet" which limits the range of available features. Optimizely Performance Edge and Optimizely integrate with Jira the same way, so all information contained in this article applies to experiments created with either version of Optimizely. This integration is only available on the Jira Cloud platform, and not on Server. ::: ## Configure Optimizely for Jira app Configuring your Jira application (*app*, sometimes called *add-on* or *integration*) is a three-step process. 1. Install the **Optimizely for Jira integration** from the [Atlassian marketplace](https://marketplace.atlassian.com/apps/1219783/optimizely-for-jira?hosting=cloud\&tab=overview) on the Jira instance. You only have to do this once per Jira account. 2. Enable the Jira integration on each Optimizely project where you want the integration to be available. 3. Connect the Optimizely and Jira accounts of each user who use the integration. :::hint{type="info"} **📘 Note** Enable the Jira integration separately for each individual Optimizely project, but you only install the Atlassian marketplace app once for each Jira instance. ::: ### Configure the app in Jira Configure this app before you use it. Your Jira administrator has the appropriate credentials to do this. 1. Log in to your Jira instance as an administrator. 2. Install the [Optimizely for Jira](https://marketplace.atlassian.com/apps/1219783/optimizely-for-jira?hosting=cloud\&tab=overview) add-on by clicking the admin drop-down list and selecting **Add-ons** (app). ### Enable the app 1. Log in to Optimizely as an administrator or project owner in the Web Experimentation project where you want to use the integration. 2. Go to **Settings > Integrations**. 3. Click **Jira** in the list of partners. 4. Toggle the switch to **On**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/tBovsqORZX8Xb8NNgx7eb_3226c58-jira-1.png) 5. Click **Connect to Jira.** This initiates the OAuth process. An Atlassian OAuth page displays.  6. Select the Jira tenant URL you want to authenticate (for instance, `company.atlassian.net`), and click **Approve**. 7. Go to **Integration Details > Settings** in Web Experimentation and click **Edit**. 8. Select the same Jira tenant URL you just authenticated. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/vc6M09B7FoRFKE1TcKqa-_5465cb8-jira-2.png) 9. Click **Save**. Your Optimizely project and your Jira instance are now connected. ### Connect users' Optimizely and Jira accounts Now that you configured the integration other users are asked to authenticate their accounts with Jira to link actions to the specific user who performed them. Users only need to authenticate once in an account, but the integration must be turned on in each project individually. This ensures the appropriate Jira URL is associated with each Optimizely project. ## Link an experiment to a Jira issue 1. In Optimizely, find the experiment you want to link to a Jira issue and click **More**. From the drop-down list, select **Link Issue** 2. A list of recently-viewed Jira issues displays. If the relevant issue is not listed there, enter the Jira issue key in the search field and click **Search**. 3. Click **Save and Link Issue**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/oU9zF4AbyHnqTQLvlHDAo_ea28e2b-jira-5.png) ## View Optimizely information in Jira The Optimizely for Jira integration is visible to Jira users in your organization, whether they have access to Optimizely or not. To find the Optimizely information within a Jira ticket, open the ticket and scroll down until you see the Optimizely logo for experiments. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/uds2DiZl0nDMhXM5zjhC__31d00cb-jira-6.png) To see information about an experiment 1. Click **Open Optimizely** from within the Jira ticket. 2. Click on either the **Experiments** or **Ideas** tab to display a list of linked experiments or ideas. 3. Click on the experiment or idea you want to view. Jira displays a summary of that experiment or idea. For **experiments**, you can see - Experiment type - Status - Date last modified - Days running - Experiment visitors - Audiences - Metrics - Variation details For **ideas**, you can see - Score - Owner - Stage - Site and touchpoint - Hypothesis - Linked experiment ## Unlink an experiment or idea from a Jira issue 1. Find the feature you want to unlink and hover over the Jira ticket link. 2. Click **Unlink**. 3. Click **Unlink Jira Issue**, if you are sure you want to unlink the Jira issue from the feature. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3RnIevL1q9nV2IbMuqeC__618d042-jira-10.png) :::hint{type="info"} **📘 Note** When you link or unlink an issue, that should be reflected immediately in both Optimizely and Jira. ::: ## Disconnect a user account To remove user-level authentication between Optimizely and Jira, complete the following steps: 1. Log in to Optimizely as the user whose authentication is to be removed. 2. Go to **Settings > Integrations**. 3. Find and click on Jira in the list of integration partners. 4. Click **Disconnect** and follow the instructions. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yDwv1xI5LHPhuPYyVXSsT_bed847a-jira-11.png) ## Troubleshoot issues  ### The integration is not visible from inside Jira If you have manually selected to use the old view in Jira, you do not be able to use this integration. You have to enable the new Jira issue view in Jira. This makes the **Releases** section visible in each of your Jira issues. 1. Within Jira, click your profile avatar and select **Personal settings**. 2. Toggle the switch for the new Jira issue view. :::hint{type="info"} **📘 Note** If **Personal settings** is not listed as an option when you click your avatar, you can find the toggle switch under **Profile** instead. ::: To learn more about the new Jira issue view, see [what is the issue view?](https://confluence.atlassian.com/jiracorecloud/the-new-jira-issue-view-938040503.html) ### Verify your integration is functioning properly There are two ways to verify your integration is working as expected. Go to **Setting > Integrations** and find the project integration settings for Jira. These should indicate that integration is switched on and connected with a Jira tenant URL. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/mol47n9KpY0w_1UjYIPLJ_18f8842-jira-12.png) Alternately, if you see the option to link or unlink Jira issues to feature flags in the **Experiments, Ideas** or **Features** dashboards, your integration is working correctly. Ensure your Jira administrator has installed the Optimizely for Jira add-on before trying to authenticate from Optimizely. Add this on the Jira side before making any authentication attempts. Sometimes, the project settings display that Jira integration is enabled, but the option to link issues from the **Experiments** dashboards is not available. This means the user has not been properly authenticated. On the Atlassian oAuth page, select the same Jira tenant URL that is listed in the Optimizely project settings. If you cannot see the **Releases** section, first ensure that **New Jira Issue View** is switched **on** in your Jira profile settings. If that does not work, check with your Jira administrator that the Optimizely for Jira app is installed in your Jira instance. ### A Jira issue does not show up in Search Possible reasons for this include the following: - The issue does not exist or was moved to a different project and has a new key. - Project integration settings do not have the Jira tenant URL that contains the issue. - The user OAuth failed.