LaunchDarkly Developer Documentation

Get started in under 30 minutes.
LaunchDarkly provides feature flags as a service for Java · Python · Ruby · Go · Node.js · PHP · .NET. Control feature launches -- who sees what and when -- without multiple code deploys. Easy dashboard for phased rollouts, targeting and segmenting.
Need more help? write us at support@launchdarkly.com

Get Started    Documentation

Overview

This topic explains how LaunchDarkly's Jira add-on allows you to link your feature flags with your team's Jira issues. When a feature flag is turned on, off, or has its targeting rules update, its associated Jira issue pages display the flag's current status.

Prerequisites

To complete this procedure, you must have the following prerequisites:

You can also give the access token a custom role allowing it to control webhooks. In the custom role policy, Allow the Jira integration to access the webhook/* resources with the createWebhook and deleteWebhook actions.

An example custom role configuration appears below:

An access token's custom role configuration in the LaunchDarkly UI.

An access token's custom role configuration in the LaunchDarkly UI.

Now that you've created an access token, use it to configure the Jira integration for your LaunchDarkly account.

  1. Navigate to your Jira instance's add-on management page, and click the "Configuration" button for the LaunchDarkly app.
  2. Set your API key.
  3. Select which environment the app will track for each of your LaunchDarkly projects. By default, the app will track your production environments.

Environment selection

If selected environments are reconfigured after issues have already been associated with flags, the existing connections display the environments they were historically connected to until the next time that flag is updated.

New flag connections display the flag configuration for the updated environment.

After you have set up the LaunchDarkly for Jira app is set up, a "Releases" panel appears when you view issues on the "Active sprints" board.

If no flags are associated with an existing Jira issue, you can add one with a button. If you already have one or more flags associated with a Jira issue, the rollout status of each connected feature flag on each Jira issue appears.

Now that the Jira app is configured, you can connect feature flags to Jira issues.

Enable the release panel

The Jira issue view, which contains the release panel, is a per-user setting. If it is off, the release panel does not appear.

To learn more, read Jira's documentation.

Creating a new feature flag from a Jira issue

To create a new flag with Jira issues:

  1. Navigate to your Jira issue's feature flag panel.
  2. Click Add feature flag select the Create feature flag option. The LaunchDarkly flag creation page opens.
The Create feature flag option.

The Create feature flag option.

  1. In the feature flag creation page, the Jira issue is pre-populated.
The feature flag creation page.

The feature flag creation page.

Connecting an existing feature flag to a Jira issue from LaunchDarkly

If you have already created a feature flag for your Jira issue, you can add a Jira issue to your existing flag by creating a custom property for your flag.

  1. Navigate to the flag's Settings page.
  2. Name the custom property Jira issues.
The flag's Settings page, configured with a `Jira issues` custom property.

The flag's Settings page, configured with a Jira issues custom property.

  1. Enter a list of Jira issue keys as the property value. You can list multiple issues if applicable.
  2. Click Save Changes.
The Jira issues custom properties field.

The Jira issues custom properties field.

Adding issues to an existing flag

Your Jira issue must exist before you associate it with your feature flag. If you accidentally added a Jira issue to your flag, delete the custom property, create your Jira issue, and try again.


Jira


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.