Because Jira Software offers flexible issue and project tracking, the Jira Cloud integration allows you to connect splits and Jira issues from either Jira or Split, and view details in both Jira and Split. With this bidirectional connection, you can track rollouts with an associated issue in Jira and issues tied to a feature flag in Split.
Jira Cloud only
This integration only works with Jira Cloud product offerings and does not work with Jira Server.
If you are having trouble completing the integration please contact us at firstname.lastname@example.org.
Setting up in Split
To set up in Split, do the following:
Go to Admin Settings and click Integrations.
Locate Jira Cloud and click Add.
Select the Workspaces and associated Environment you want to connect to Jira Cloud.
Note: You can select multiple workspaces but only one environment per workspace.
Click Save to generate a token. You can now configure the Jira Cloud.
Setting up in Jira
To set up in Jira, do the following:
In the Atlassian Marketplace, install Split in your Jira Cloud instance.
Within Apps in Jira Cloud, and after the Split app is installed, click Configure integration in the side menu under Split.
Enter the token you copied and click Save.
With the app configured, you can connect Split to Jira issues.
Connecting your integration
To connect this integration, you can do either of the following:
From Split: Navigate to the Additional settings tab on the split and click the Connect Jira Issue button. Enter the desired issue number.
From Jira: In the right hand column of an issue, click More fields to expand the section and then click Releases +. When you click the plus sign, you can either create a split or connect to an existing split.
- Selecting Create feature flag takes you to your Split organization and the standard split creation dialog opens, with the current Jira ticket entered.
- Selecting Connect a flag takes you to a new dialog box that allows you to choose a split. You can connect multiple splits to an issue and multiple issues to a split.
Note: You must select a Split Workspace that has been configured in the Jira integration setup. A Jira instance is 1:1 with a Split Organization and the integration can be configured for one or more Workspaces.
Viewing your connections
Once you’re connected, you can do either of the following:
In Split: You see all attached issues on the Additional settings tab.
In Jira: You see either the name of the flag or the number of flags to which that issue is connected. On the right hand side, it indicates if the splits are active in the primary Environment, which is selected for each Workspace when the integration is set up.
If you have multiple flags, hovering over the status indicator shows the status of all flags. If you have only one flag, hovering over the status displays information about the rollout plan.
If you click on the flag name or the text telling you how many flags there are, a dialog box opens with a link to the flag, the primary environment, the status of each flag, and the last time the flag was saved.
For Rollout details, if you only use the Default rule, it shows you the percentage that is allocated to the same treatment you chose for the Default treatment. Otherwise, it shows you the number of rules that you have on the flag.
Note: Because you can navigate to the feature flag, we no longer send and store all of the changes in Jira.
Disconnecting an issue
To disconnect an issue from a split, you can do so on the Additional settings tab of the split.