> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating to Jira Forge

<View title="Developer" />

<View title="Federal docs" />

<View title="EU docs" />

<View title="Federal docs">
  <Danger>
    **This integration is not available in federal environments**

    To learn more, read <a href="/docs/home/infrastructure/federal">LaunchDarkly in federal environments</a>.
  </Danger>
</View>

<View title="Developer">
  <Note>
    **Attention: EU Customers**

    Read the <a href="/docs/integrations/jira-forge">EU migration guide</a> for instructions on migrating while using the LaunchDarkly European Union (EU) instance.
  </Note>
</View>

This topic explains how to migrate your Jira Cloud integration from Jira Connect to Jira Forge and how to upgrade an existing Jira Forge installation to the latest major version.

If you have an existing integration between LaunchDarkly and Jira that you set up before March 2026, you must follow the instructions in this migration guide to maintain the integration.

If you already use the Jira Forge app and want to upgrade to the latest major version, read [Upgrade an existing Jira Forge installation](#upgrade-an-existing-jira-forge-installation).

## Prerequisites

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

<ul>
  <View title="Developer"><li>The "LaunchDarkly for Jira" app from the [Atlassian Marketplace](https://marketplace.atlassian.com/apps/1219142/launchdarkly-for-jira?hosting=cloud\&tab=overview) in your Jira Cloud instance.</li></View>

  <View title="EU docs"><li>The "LaunchDarkly for Jira (EU)" app from the [Atlassian Marketplace](https://marketplace.atlassian.com/apps/1238314/launchdarkly-for-jira-eu?hosting=cloud\&tab=overview) in your Jira Cloud instance.</li></View>

  <li>A personal or service API access token. To learn more, read [API access tokens](/docs/home/account/api).</li>
  <li>Administrator permissions in Jira.</li>
</ul>

## Give your new API access token the required permissions

To begin, give your new API access token the required permissions. To learn how, read [Give your API access token the required permissions](/docs/integrations/jira#give-your-api-access-token-the-required-permissions).

## Reconfigure the LaunchDarkly integration in Jira

Next, reconfigure the LaunchDarkly integration in Jira, including:

* Entering your new API access token.
* Re-selecting which environments the app tracks for each of your LaunchDarkly projects.

To configure this, read [Configure the LaunchDarkly integration in Jira](/docs/integrations/jira#configure-the-launchdarkly-integration-in-jira).

## Upgrade an existing Jira Forge installation

If you already use the LaunchDarkly for Jira Forge app, you must clear and re-enter your API access token after a major version update. Atlassian does not automatically apply major version updates, so you must upgrade the app in your Jira site, then reconfigure the token so LaunchDarkly can create an updated subscription.

<View title="Developer">
  This upgrade applies when you move from version 15 to version 16 of the LaunchDarkly for Jira app.
</View>

<View title="EU docs">
  This upgrade applies when you move from version 3 to version 4 of the LaunchDarkly for Jira (EU) app.
</View>

### Upgrade the app in Jira

To upgrade the app:

1. Navigate to your Jira instance's app management page.
2. Find your LaunchDarkly for Jira app.
3. Upgrade to the latest version when prompted.

### Re-enter your API access token

Clearing and re-entering the token creates a new subscription with the updated configuration.

To re-enter your API access token:

1. Navigate to your Jira instance's app management page.
2. Click the **Configuration** button for the LaunchDarkly app. The "Configure LaunchDarkly Integration" screen appears.
3. Clear the existing API access token.
4. Enter your API access token again.
5. Re-select which environments the app tracks for each of your LaunchDarkly projects.
6. Save the configuration.

To learn more, read [Configure the LaunchDarkly integration in Jira](/docs/integrations/jira#configure-the-launchdarkly-integration-in-jira).