When pushing a feature or subfeature into Jira, you can link it to an existing issue in Jira. If you accidentally push a feature to the wrong Jira issue, you can unlink it from your Jira issue. This removes the Productboard URL and allows you to relink that Jira issue to a different Productboard feature or subfeature.
In this article:
- Linking a Productboard feature to an existing issue in Jira
- Unlinking a feature or a subfeature from a Jira issue
Linking a Productboard feature to an existing issue in Jira
Linking a Productboard feature to an existing issue in Jira addresses the situation when you already have an existing issue in Jira that you would like to connect to your existing features and subfeatures in Productboard. You can find the Jira feature to link to by inserting the issue URL, and issue ID or using JQL queries.
To link a Productboard feature to an existing Jira issue:
- Find the item you wish to push to Jira and click the Push button. This button can be found by opening the item's details sidebar or from the Jira integration column on a features board or grid.
- Click the Link to Existing tab.
- Enter the Jira issue ID or use JQL to search for the existing issue.
- Select the existing Jira issue you’d like to link to and click the Link button.
- Choose whether you'd like to have the data in Productboard override the data in Jira or vice versa, then click Link.
Unlinking a feature or a subfeature from a Jira issue
You can break the link between a Jira issue and a Productboard item from within Productboard. This removes the Productboard URL and allows you to relink that Jira issue to a different Productboard item.
To unlink a Productboard item from a Jira issue:
- Click on the item in Productboard to open its details sidebar.
- Scroll down to the Jira integration field.
- Click Unlink to unlink the feature from the Jira issue. You may have to open the ••• More actions menu to reveal the unlink button.
school Productboard Academy Webinar
Learn best practices for setting up your Jira integration in our on-demand webinar. A member of Team Productboard will explain key concepts, share tips, and answer all your questions so you feel prepared to hit the ground running.
Note: Webinars are available for trial users and paid customers only.
school Productboard Academy Course
Take a look at our quick tip academy course on safely activating the JIRA Integration. You can safely turn it on and configure it however you like before information starts flowing back and forth. Here's a video walkthrough if you don't believe us.