• Documentation

Integrate with feature flags

Connecting feature flags to Jira gives your team immediate insight into the release status of your work and helps you monitor the rollout of new features.

The releases panel on the Jira issue view summarizes current feature flag status, revealing more information within a tooltip, including:

  • how many feature flags are connected to this issue

  • which feature flags are enabled

  • percentage of customers in the rollout

  • which flags have rules applied

If your team uses releases and versions to organize their work, you can also track feature flag information in the Releases hub. The Feature flag column shows you when an issue has a feature flag linked to it, whether the flag is enabled or disabled, and what the percentage rollout is for that particular flag.

Connect Jira to your feature flag tools

We support various tools for feature flag management, including LaunchDarkly and Split. You can find the full list of supported tools on the Atlassian Marketplace.

Install the feature management app

You can install feature management apps through the Atlassian Marketplace.

To install apps, you must be an administrator (a member of the site-adminsadministrators or jira-administrators group).

  1. Log in to your software project

  2. Select the settings icon in the main navigation and then select Apps.

  3. Select Find new apps in the side menu.

  4. Find the app you want to enable in the Marketplace.

    1. LaunchDarkly for Jira

    2. Split

    3. Harness Feature Flags for Jira

  5. Select the app to display its details view.

  6. Select Install.

Configure the app

LaunchDarkly

  1. Select the settings icon in the main navigation and then select Apps.

  2. Select Manage apps

  3. Find LaunchDarkly in the list.

  4. Select the app to display its details view.

  5. Select Configure.

  6. Add your LaunchDarkly API key.

  7. Select Save

Split

  1. Select the settings icon in the main navigation and then select Apps.

  2. Select Manage apps

  3. Find Split in the list.

  4. Select the app to display its details view.

  5. Select Configure.

  6. Add your Split token.

  7. Select Save.

Harness

  1. Select the settings icon in the main navigation and then select Apps.

  2. Select Manage apps

  3. Find Split in the list.

  4. Select the app to display its details view.

  5. Select Configure.

  6. Add your Harness token.

  7. Select Save.

Create and connect a feature flag

You can add a feature flag to a Jira issue via the releases panel on an issue, or via the Releases hub.

Adding via the Jira issue: In the releases panel on your Jira issue view, select + Add feature flag and, depending on which tool you've integrated, you'll get the option to create a new flag, or connect an existing one. We'll pass the relevant information on to your flag provider so you can get connected as quickly as possible.

Releases with feature flag dropdown

Adding via the Releases hub: Navigate to your Jira version and hover over an issue row in the Issues table. Select Add flag to create a new flag in your connected feature flag tool, or to connect an existing flag. You can also select Install another tool to add a new feature flag tool.

Once you've selected the relevant option to create or connect a feature flag, you'll be taken to your provider's site to complete the process.

For more details see:

Once the flag has a Jira issue key linked to it, you will see feature flag information in the following places:

  • In Jira issues: your feature flag status will display in the releases panel on your Jira issue, with a tooltip that shows more detail

Releases panel on the Jira issue view showing linked feature flags
  • In the Releases hub: when you view a version, feature flag information will display in the Feature flag column of the Issues table

Issues table on the Release page, showing the Feature Flag column

Still need help?

The Atlassian Community is here for you.