Linking or unlinking Productboard features and subfeatures to existing issues in Jira

The following capabilities are available on all Productboard plans.

 

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:

Relevant to both new and legacy boards

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:

  1. 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. 
  2. Click the Link to Existing tab.
  3. Enter the Jira issue ID or use JQL to search for the existing issue.
  4. Select the existing Jira issue you’d like to link to and click the Link button.
  5. 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:

  1. Click on the item in Productboard to open its details sidebar.
  2. Scroll down to the Jira integration field.
  3. 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.

Watch now!

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.

Watch now!

See also:

Was this article helpful?
1 out of 2 found this helpful

Articles in this section

See more
Our Support hours:
Monday to Friday from 9:00 am - 2:00 am CET. Monday to Friday from 0:00 am - 5:00 pm PST.
Productboard Academy
Become a Productboard expert with self-paced courses, quick tip videos, webinars and more.
Product Makers Community
Connect with product leaders, share and find product jobs, and learn how to approach similar challenges. Come join our Product Makers community.