Integrate with Jira

Diana Stegall
Written by Diana Stegall




Align your product strategy with execution with Productboard's Jira integration.

Productboard serves as your single source of truth - capture and prioritize your feature ideas, push features to delivery, and monitor progress all from within a single dashboard. 

In this article, you'll learn how to use our Jira integration to unify your product and engineering workflows.

To learn more about how to set up your Jira integration, see our article Getting started with Jira.

If you're trying to solve a problem, see our article Troubleshooting Jira.

You may also be interested in our articles about working with Jira next-gen projects and Jira self-managed.

In this article:

Push features from Productboard into Jira

Once the Jira integration is enabled, you can push a feature into Jira in its details side pane:

push.button.pngYou can also display a special Jira task column on your boards:


The Jira task column allows you to easily push many features into Jira:

task.status.pngAt the moment you push a feature into Jira, you can decide its issue type. This can always be updated later in Jira. You can also choose to link a Productboard feature to an existing issue in Jira.


Features in Productboard are typically pushed to Jira as epics.

  • In some cases you may have small, yet important, ideas represented as features in Productboard. These can be pushed to Jira as stories, bugs, tasks, or other custom issue types.
  • Even after pushing a feature to Jira, you can always update its issue type in Jira.

Once features are pushed, whether from the details pane or task column, you'll see the issue's status displayed (and issue ID on hover). Select this to navigate to the issue in Jira. (You can use the Productboard URL field on issues to navigate back to features in Productboard.)

task.status.pngPush subfeatures from Productboard into Jira

Subfeatures can be pushed to Jira in the same way as features.

    • Subfeatures are typically pushed to Jira as Stories, but they can also be pushed as Bugs, Tasks, Sub-tasks, or other custom issue types.
    • You need to push subfeatures individually. For example, if you push a feature, the subfeatures won't be pushed automatically.
    • If you push the feature as an Epic, the connected subfeatures you push will automatically be linked to the Epic in JIRA. 
      Note: If you push a subfeature as an Epic, it won't be linked to the parent feature that's also an Epic.
    • Even after pushing a subfeature to Jira, you can change it to a feature at any stage. You can also update its issue type in Jira.
    • When pushing subfeatures as Sub-tasks, their parent features will be pushed into Jira as well. (In Jira, Sub-tasks must have a parent).


Mapping fields between Jira and Productboard

When features/subfeatures are pushed into Jira, their fields are mapped to Jira issue fields in the following way:

Productboard | Jira

  • Feature name | Issue name
  • Feature name | Issue summary
  • Feature description | Issue description
  • Jira "Task" status | Issue status
  • Release | Fix version
  • Feature owner | Reporter 

Reporter is only mapped if a user with a matching email address exists in Jira.

Assignee is left blank so it can be filled out in Jira.

Below, you can find how JIRA custom fields map to fields in Productboard:



Using Markdown in a feature description

If your Productboard feature description contains the following Markdown elements, those elements will be represented in your Jira issue description:

  • Underline
  • Quotes
  • Jira color tag


Unlink a feature or a subfeature from a Jira issue

No longer wish to link a Productboard feature or subfeature to a Jira issue? Accidentally pushed a feature to the wrong Jira issue? You can unlink your Jira issue, which removes the Productboard URL and allows you to relink that Jira issue to a different Productboard feature or subfeature:

  1. Click on the Productboard feature to open the feature description window.
  2. Scroll down to the Jira integration field.
  3. Click the broken link icon to unlink the feature from the Jira issue.

Push a release into Jira

You can push a release and all its underlying features and subfeatures into Jira. You'll find this option in the side pane after selecting the release to access its details.

  • Releases are mapped to Jira fix versions.
  • If you have multiple release groups in Productboard, you can decide which one to map to Jira fix version in Productboard's Jira integration settings.
  • When pushing a release into Jira you can decide whether to push just the release, or push all features in the release as well.
  • A releases may automatically be pushed to Jira if a feature that's already been pushed to Jira is added to that release. In this case, it's no longer possible to manually push the release (and all the rest of its features) to Jira
  • All releases within the same release group must have a unique name. Creating a release without a name will create a release called "Unnamed release".

Import Jira issues into Productboard

One-time imports

You can perform one-time imports of Jira issues into Productboard from Productboard's Jira integration settings. This is especially helpful if you previously used Jira to organize your feature backlog and are adopting a product management system for the first time.

If you would like to import many issues, it's recommended that you do so in batches that will all be added to the same area of your product hierarchy.


Auto imports

You can also use JQL to auto-import certain types of new issues into Productboard on an ongoing basis. For example, if your team logs certain types of unexpected behavior directly in Jira, you may decide to add these to Productboard as well so they can be prioritized against other feature ideas. These features are automatically tagged Jira-auto-import so you can easily find them in Productboard. (Psst...need help writing a JQL query? Here's a cheat sheet.)


Deactivate the Jira integration

You can deactivate the Jira integration at any time by selecting Remove on the Integrations page.


Frequently asked questions

How do I add a Jira administrator?

Follow these steps:

  1. Go to Settings › Projects.
  2. Choose the project you have connected to Productboard.
  3. Under 'People' click 'Add People'
  4.  Add the project admin

Which features can I push into Jira?

Features beneath any given component can only be pushed to a single project. As soon as one feature has been pushed into a given project, all sibling features under the same component must be pushed into the same project.


If I delete a feature in Productboard that's already linked to Jira will the 2-way sync delete the story in Jira?

No, the Productboard link in Jira will disappear but the data in Jira will remain.


Is it possible to import existing Jira fix versions into Productboard?

Not quite, but there's a trick. If you create a release by the same name in Productboard, when you push features within that release into Jira, they will automatically sync with the existing fix version.


Is it possible to push a Productboard component to an epic in Jira?

It is no longer possible to push components to Jira. 

Components are useful for organizing feature ideas in Productboard (e.g. around user need, product area, or technical component) but do not represent ideas that are to be executed. We recommend using features for that.


Is it possible to map the JIRA timeframe to a feature timeframe? 

The JIRA timeframe can't be mapped in-app to a feature timeframe however it can be done via our API.


Watch an on-demand webinar!

Learn best practices for setting up your Jira integration. 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.


👉Save your seat 👈


See also:

Was this article helpful?
6 out of 8 found this helpful