Configuring Jira integration settings

The following capabilities are available on all Productboard plans.

 

Once you have set up your integration, it’s time to configure the integration’s settings to make it serve your workflow.

In this article: 

A banner indicating that the features described in the following article or section are available on both New and Legacy boards.

Integration health

The Integration health section indicates if your integration rocks or if there is room for improvement.

There are several states that the section can show:

  1. Your Jira integration rocks!
    No action is required! Your integration is well connected, nothing to improve.
    Untitled__60_.png
  2. Warning: Parts of your Jira configuration might be wrong.
    Click on Show details and explore the ways to improve your integration connection
    Untitled__61_.png
  3. Something went wrong while running checks. X checks out of 5 failed.
    This means that the connection is down. Please click on Show details to see what checks exactly have failed. You will also find a link to the articles that can help you to solve these errors.
    Untitled__62_.png

    For more information, see Troubleshooting Jira.

Workspace connection

The section contains information about the status of your Jira workspace connection (e.g. http://kidsfriendly.atlassian.net/) and active authorizations. You can also navigate to the Workspace Management page from here - just click on the Manage Workspace button.

Untitled__64_.png

For more information on how to re-authorize or remove the authorization of your integration, see the article Managing Jira integrations.

Project and issue types

If items will need to be pushed to more than one Jira project, you'll want to leave this setting on "Let me choose...". This allows the user to decide which project to push to every time they push an item.

If you know that you'll constantly be pushing features to the same Jira project, select it here and save time with every push. 

See Integrating with multiple Jira projects for more details. +

Note: This field can have an impact on your field mapping. See Mapping fields between Jira and Productboard for details. 

 

Associated products ( productboard Vessel (close crop).png Enterprise plan only)

Associated products enable you to associate the integration with the Productboard products that are relevant to your particular Jira project(s).

If you know that you won't be pushing features to your Jira project from one of your Productboard products, you can unselect that product here.

Automatic Import

If you enable this setting, you will create a trigger to automatically import a feature in Productboard each time the item is created in Jira.

Auto-import can only create features in one product. If you wish to auto-import features into multiple parts of your product hierarchy, you must create multiple Jira integrations. (e.g. one Jira integration auto-imports into "Brickly Desktop", another Jira integration auto-imports into "Brickly Mobile", etc.)

See Configuring multiple Jira integrations for details. 

Release syncing

Leaving the setting box checked will sync your Productboard release group with your Jira fix versions.

Each Jira integration can only sync fix versions to one release group in Productboard. If your team works with multiple release groups, we recommend creating multiple Jira integrations (see the article, Integrating with multiple Jira projects).

Untitled__63_.png

For more information see, Pushing a release into Jira

Field Mapping and syncing

In this section, you can map the fields that correspond to your workflow and select the synchronization type to define the sync behavior between Productboard and Jira.
Untitled__65_.png

For more information on field mapping, see Mapping fields between Jira and Productboard.

Status update syncing

In this section, we invite you to configure the status update sync for your workflow and reduce the manual updates once and for all.

Untitled__66_.png

For more information, see Automatically update a Productboard feature status based on a Jira issue status.

Status Colors

Tell Productboard which color to use for each of your Jira statuses.

One-time import

Have a backlog of working items in Jira and would like to import them to Productboard in bulk? This section is exactly for this!

Untitled__68_.png

For more information on finding out more about ways to bring your backlog to Productboard, see Importing Jira issues into Productboard.

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?
0 out of 1 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.