Skip to main content
menu-icon.png

 

x
Optimizely Knowledge Base

Integrate Optimizely with Jira

 
relevant products:
  • Optimizely X Web Experimentation
  • Optimizely X Full Stack
  • Optimizely Program Management
THIS ARTICLE WILL HELP YOU:
  • Configure your organization's Jira integration
  • Connect your Optimizely account to your Jira account
  • Link and unlink experiment, campaigns, feature flags, rollouts and ideas to Jira tickets
  • Disconnect your Jira authorization from your Optimizely account

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 by linking Jira issues to Optimizely’s Web, Full Stack, and Program Management products. Natively link Optimizely experiments, personalization campaigns, feature flags and rollouts, and Program Management ideas to Jira issues. Then track their status directly from the relevant Jira ticket.

You can also integrate Jira with Optimizely Full Stack and Optimizely Rollouts. See our developer documentation for more details.

This integration is only available on the Jira Cloud platform, and not on Server.

Set up the Optimizely for Jira integration

Setting up your Jira integration is a three-step process:

  1. Install the Optimizely for Jira app from the Atlassian marketplace on the Jira instance. You will only have to do this once per Jira account.

  2. Enable the Jira integration on each Optimizely project where you'd like the integration to be available.

For Program Management, you can either enable the Jira integration on at least one Optimizely Web or Full Stack project, or you can OAuth directly from Program Management itself. If you choose the latter, whenever you authorize a Program Management team, you will also authorize all projects tied to that team.

  1. Connect the Optimizely and Jira accounts of each user who will be using the integration.

Remember, you will have to enable the Jira integration separately for each individual Optimizely project, but you will only have to install the Atlassian marketplace app once for each Jira instance.

Configure the integration in Jira

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.

Enable the integration in Optimizely

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

  2. Navigate to Settings in the left menu bar and click on the Integrations tab at the top of the page.

  3. Find and click on Jira in the list of integration partners.

  4. In the panel that appears on the right, toggle the on-off switch to On.

jira_tenant_url.png

  1. Click Connect to Jira. This initiates the OAuth process.

  2. An Atlassian OAuth page will appear. Select the Jira tenant URL you wish to authenticate (e.g., company.atlassian.net), and click Approve.

  3. Back in Optimizely, in the right panel under Integration Details > Settings, click Edit and select the same Jira tenant URL you just authenticated.

jira_tenant_url_2.png

  1. Click Save. Your Optimizely project and your Jira instance are now connected.

Connect users' Optimizely and Jira accounts

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.

Link an experiment, feature, or idea to a Jira issue

  1. If you are using Optimizely Web or Full Stack, find the experiment, feature, or idea you wish to link to a Jira issue and click ... at the far right-hand side. From the drop-down list, select Link Issue...

Screen Shot 2019-03-12 at 3.19.35 PM.png

If you are using Program Management, find the idea you wish to link to a Jira issue and click ... at the far right-hand side. From the drop-down list, select Link Issue...

Screen Shot 2019-03-12 at 3.23.13 PM.png

  1. The Link Jira Issue modal will appear. A list of recently-viewed Jira issues will be visible at the bottom. If the relevant issue is not listed there, enter the Jira issue key in the search field and click Search.

  2. Click Save and Link Issue.

Screen Shot 2019-03-12 at 3.39.49 PM.png

View Optimizely information in Jira

The Optimizely for Jira integration is visible to all 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 the right side until you see the Optimizely logo (for experiments and ideas) or the word "Releases” (for feature flags).

To see more information about an experiment or idea, follow these steps: 

  1. Click on the appropriate tab to display lists of all linked experiments or ideas.

[INSERT SCREEN CAP HERE]

  1. Click on the experiment or idea you want to view.

For experiments, all Jira users will be able to see:

  • Experiment type

  • Status

  • Date last modified

  • Days running

  • Experiment visitors

  • Audiences

  • Metrics

  • Variation details

For ideas, all Jira users will be able to see:

  • Score

  • Owner

  • Stage

  • Site and touchpoint

  • Hypothesis

  • Linked experiment

For feature flags, the integration includes the name of the feature and its current status. Hovering over the flag status displays the current percentage of roll-out for the feature. Clicking on the feature name opens it directly in Optimizely.

Unlink an experiment, feature, or idea 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.

jira_7.png

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

jira_8_unlink.png

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, follow these steps:

  1. Navigate to the experimentation portal.

  2. Log in to Optimizely as the user whose authentication is to be removed.

  3. From the Experimentation platform, navigate to Settings > Integrations.

  4. Find and click on Jira in the list of integration partners.

  5. In the panel that appears on the right, click Disconnect (next to the user avatar) and follow the instructions.

Disconnect screen 2.png

Troubleshooting 

The integration is not visible from inside Jira

If you have manually selected to use the old view in Jira, you will not be able to 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.

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 Experiments, Ideas or Features dashboards, 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 Experiments, Ideas or Features dashboards 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.

A Jira issue doesn't show up in Search

There are three possible reasons for this: 

  • The issue doesn’t exist or was moved to a different project and has a new key

  • Project integration settings does not have the Jira tenant URL that contains the issue

  • The user OAuth failed

Feature flag module isn't visible inside of Jira

This is likely because you have not enabled the new Jira view. Click the link to review that section of this article.