Integrate with Jira



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, maker+admins can push a feature into Jira in its details side pane:


Maker+admins can also display a special Jira task column on your boards:


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


At the moment you push a feature into Jira, you can decide its issue type. You can push a Productboard feature as new by clicking Push as New or link a Productboard feature to an existing issue in Jira. This can always be updated later 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.)


Linking a Productboard feature to an existing issue in Jira

When pushing a feature into Jira, you can decide its issue type. This can be linking a Productboard feature to an existing issue in Jira. 

  • To link a Productboard feature to an existing Jira issue, click the Link to Existing tab.
    Jira link 1.png
  • Enter the Jira issue ID or use JQL to search for the existing issue.
    jira link 2.png
  • Select the existing Jira issue you’d like to link to and click the Link button.
    jira link 3.png
  • If you’d like Productboard feature data to override the existing Jira issue data, click the Keep Productboard data button and then click the Link button.
    jira link 4.png
  • Alternatively, If you’d like the existing Jira issue data to override the Productboard feature data, click the Accept Jira data button and then click the Link button.
    jira link 5.png

Push 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.
    • Maker+admins need to push subfeatures individually. For example, if you push a feature, the subfeatures won't be pushed automatically.
    • If a maker+admin pushes 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, maker+admins 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, the fields are mapped to Jira issue fields based on your field mapper configuration. Productboard <> Jira fields are generally mapped to Jira issue fields in the following way:

Productboard | Jira

  • Feature name | Issue name
  • Feature description | Issue description.- In Jira, make sure to configure this field to be rich-text so we can support formatting. Learn more
  • Feature Timeframe from | Jira Issue Start Date
  • Feature Timeframe to | Jira Issue Due Date
  • Jira "Task" status | Issue status
  • Release | Fix version
  • Feature owner | Reporter 
  • Effort | Story points
  • Feature Tags | Jira Labels

Reporter is only mapped if a user with a matching email address exists 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

Automatically update a Productboard feature status based on a Jira issue status

Screenshot 2022-05-09 at 11.50.07.png

The Jira status automation sync is available in Productboard! This will allow you to easily track from Productboard what is happening across your delivery teams and make it easier for you to keep your stakeholders aligned. For information on setting up the status sync, see the article Automatically update a Productboard feature status based on a Jira issue status.

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

Maker+admins can push a release and all its underlying features and subfeatures into Jira. You'll find this option in the side panel 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.
  • Clicking on the push button will push the release to Jira, but the “unpushed” state will remain. If the release already exists in the Jira the dialog will notify you about it.
  • 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".

Note: Please ensure the Fix Version checkbox is ticked in the Jira Integration settings on Productboard to push the release through.

image (39).png

Import Jira issues into Productboard

One-time imports

Maker+admins 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.

When you map custom fields of the same type between Jira and Productboard these fields will be one-time imported from Jira to Productboard.

This applies only:

  1. To fields that are of the same data type. (Productboard supports text (plain-text), number, and dropdown custom fields).
  2. If the fields were mapped BEFORE the one-time import. 


Screenshot 2022-03-21 at 19.02.58.png


Auto imports

Maker+admins 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.)

Field mapper and 2-way sync

The Jira 2 way sync is used to automatically update your Productboard feature and your Jira issue when there is a change in either platform.

Note: Only an admin maker can enable the 2-way sync through in your Productboard space. (41).gif

To enable 2-way sync:

  1. Navigate to your avatar and click Integrations (Integration-1.svg).
  2. Scroll down to open the specific Jira integration and scroll to the section Field mapping and syncing
  3. Click on the + Add Mapping button
  4. Select a Productboard field that you would like to map
  5. Select a Jira Field that you would like to map the Productboard field to
  6. Select the synchronization behavior:
    1. Select 2-way sync if you want to keep the field synchronized at all times
    2. Select Set once, if you want the synchronization to apply ONLY during the Push, link, or import operations
  7. Go through steps 4 -7 as many times as you need to map all the fields that you and your team care about
  8. Click on the Save Field Mapping Button

Once you have selected the 2-way sync button, nothing will happen initially.

Note: Text formatting between Productboard and a Jira Multiline Custom Field may not be visible. Paragraph custom fields need to be explicitly configured in Jira to display formatted text synched from Productboard. Navigate to Jira and set the field Renderers using Wiki Style Renderer. Learn more

Pre-existing links will now update when there is a change in either platform.

If you have no pre-existing links, you will either need to conduct the one-time import or push individual features from Productboad to your Jira issues.

Deactivate the Jira integration

A maker+admin 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 push a feature to Jira that includes an attachment, what happens to the attachment?

When pushing features to Jira that includes attachments, the attachments will not sync in Jira, but if an image is pasted into the Productboard feature description, that image will be pushed to Jira.

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 releases into Productboard?

Not quite, there is no direct action to import or export releases from one system to another. If one release is missing in the other system and is assigned to a feature (or issue) that is linked or being imported or pushed, the release is automatically created in the opposite system and correctly assigned.

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.

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?
15 out of 20 found this helpful



Article is closed for comments.

Articles in this section

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.