Skip to main content


Optimizely Knowledge Base

Integrate Optimizely with Jira

relevant products:
  • Optimizely X Full Stack
  • Configure your organization's Jira integration
  • Unlink your Optimizely feature flags from Jira tickets

Many Optimizely customers also manage the development of features and experiments within Jira. This integration allows users to connect their Optimizely and Jira workflows without unnecessary duplication of effort.

Configure and enable the integration

This integration must be configured before you can use it. Your Jira adminstrator will have the appropriate credentials to do this.

  1. Log in to your Jira instance as an administrator.

  2. Install the Optimizely for Jira add-on by clicking the admin dropdown and choosing Add-ons. You can find the Optimizely for Jira app in the Atlassian Marketplace here.

  3. Login to Optimizely as an administrator or project owner in the Optimizely Full Stack project where you want to use the integration.

  4. Navigate to the Jira integration and, under Integration Details, toggle the on-off switch to On.

  5. Click Connect to Jira to initiate the OAuth process.

  6. On the OAuth page in Jira, select the Jira tenant URL you wish to authenticate (e.g.

  7. In Optimizely, click Edit (under Integration Details) and select the same Jira tenant URL you just authenticated.

Screen Shot 2018-11-27 at 10.55.43 AM.png

  1. Click Save.

Now that the integration is set up, other users will be asked to authenticate their accounts with Jira in order 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 to each Optimizely project.

Enable the new issue view in Jira

Before you can take advantage of this integration, you will have to enable the new Jira issue view in Jira. This will make visible the Releases section in each of your Jira issues.

  1. Within Jira, click your profile avatar in the lower-left corner and select Personal settings.

  2. Toggle the switch for the new Jira issue view.

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, just click here.

Link a feature to a Jira issue

  1. Find the feature you wish to link to a Jira issue and click ... at the far right-hand side. From the drop-down list, select Link Issue...


  1. The Link Jira Issue modal will appear. Enter the Jira issue key in the search field and click Add Issue.

Screen Shot 2018-11-28 at 10.20.36 AM.png

  1. Once you've selected all the Jira issues you want to link, click Save Linked Issues.

Screen Shot 2018-11-28 at 10.46.52 AM.png

Unlink a feature from a Jira issue

  1. Find the feature you wish to unlink and hover over the Jira ticket link. In the callout that appears, click Unlink.


  1. If you're sure you want to unlink the Jira issue from the feature, click Unlink Jira Issue.


When you link or unlink an issue, that should be reflected immediately in both Optimizely and Jira. 

Troubleshooting: verify your integration is functioning properly

There are two ways to verify your integration is working as expected. Navigate 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.

Screen Shot 2018-11-28 at 10.38.32 AM.png

Alternately, if you see the option to link or unlink Jira issues to feature flags in the Features dashboard as shown in the section above, your integration is working correctly.

If it turns out that your integration isn't working as expected, make sure your Jira administrator has installed the Optimizely for Jira add-on before trying to authenticate from Optimizely. This has to be added on the Jira side before any authentication attempts are made.

Sometimes, the project settings show that Jira integration is enabled, but the option to link issues from the Features dashboard is not available. This means the user has not been properly authenticated. On the Atlassian oAuth page, be sure to select the same Jira tenant URL that is listed in the Optimizely project settings.

If you can't see the Releases section on the right side of your Jira issues, first make sure that New Jira Issue View is switched on in your Jira profile settings. If that doesn't work, check with your Jira administrator that the Optimizely for Jira app is installed in your Jira instance.