Integrate ProductPlan with Jira to better connect your strategic roadmap to your specific project details that are being planned and tracked in Jira. The integration lets you connect ProductPlan Bars or Containers with Jira Epics or other issues.
You can link to existing issues or you can create new ones from ProductPlan and push them to Jira. After linking, you can choose to automatically synchronize data in ProductPlan with updates in Jira.
The integration works with both Atlassian Cloud, as well as the installed on-premise version. If you have an on-premise Jira server, it will need to be accessible from outside the firewall. You can find the steps for configuration, either for the cloud or on-premise server here, or contact firstname.lastname@example.org for further assistance.
Watch the setup video here.
Custom Mapping of Fields for Jira
Once you have successfully configured the integration you can begin choosing which custom fields you’d like to map. First, select a Jira project where all desired fields are represented and will be synced to ProductPlan, examples include: summary, description, labels, and dates. You will be able to link from multiple Jira projects to ProductPlan later on, but the initial set up requires one project to source sample fields from to build out the mapping. Note: You will not be able to hit Sync until you have configured the mapping.
For Basic Plans, the default mapped fields between ProductPlan and Jira are fixed and include: Title, Description, Tags, Percent Complete, Start Date, End Date, and Notes.
For Professional and Enterprise Plans, you will be able to customize which fields in Jira will map to the core fields in ProductPlan, as well as add additional fields. If your team is utilizing Custom Text Fields, you will also have the option to map those fields to your desired Jira fields as well.
For information on upgrading to our Professional or Enterprise subscriptions email us at email@example.com.
How to Link ProductPlan Bars to Jira
You can now link Bars and Containers to Epics or other issues in Jira. You can either link them to existing issues, or create new issues to push to Jira. You can link multiple issues from Jira to a single Bar or Container in ProductPlan. You can also link to a Jira query, which will allow you to link to multiple issues in Jira at once.
Note: When you Link a Bar or Container to an item in Jira, any information in the Bar or Container will be overridden by the information pulling from Jira.
To link to an existing Epic or issue, click on a Bar or Container and click “Links” at the bottom of the details page. Select the Jira tab, and then you can search by the exact ID or Summary text of the issue you want to link by Jira issue, or copy and paste a Jira query from your Search issues page.
You can also generate a new issue and push it directly into Jira. Click the ellipsis in the top right corner and select “Add to Jira” to push the item to a Jira project.
Once linked, you and your viewers can click between ProductPlan and the Jira issue.
Synchronizing With Jira
You can set ProductPlan to automatically update the fields from Jira to a Bar or Container. You can choose to sync Percent Complete based on:
The number of stories completed in an Epic
Story points of all stories in an Epic or Issue
You can configure these options from your integrations page. Once set up, the roadmap will automatically sync daily at 5:00 a.m. UTC, or you can manually sync any time by clicking the Sync Now button. You can read more about synchronizing fields with Jira here.
Importing From Jira to ProductPlan
You can import multiple issues from Jira directly to your Parked section of the Table Layout in your roadmap. Importing issues will automatically create the issue links in ProductPlan. Importing from Jira can also bring in and sync any labels as tags in ProductPlan. You are able to schedule an automatic, daily import of your issues page so as to automate your roadmapping process even more. Read more about importing from Jira here.
Configuring Bars to Synchronize
Once the synchronization is set up, any new ProductPlan Bars or Containers that you link to Jira will automatically be synchronized. You’ll need to manually set the synchronization for any Bars or Containers that you previously linked to Jira.
To disable the synchronization, click the link icon on the Details screen. You can then set the Percent Complete manually.
You can enable the synchronization by clicking the link icon. The Percent Complete will update at the next daily synchronization or when you click the Sync Now button from the Integrations page.
We use Jira’s OAUTH for identity management, so at no point are user passwords entered into or stored on our system. Revocable tokens are stored on a per-user basis, ensuring that each user’s access in the system matches their access in Jira. ProductPlan’s connection to Jira APIs is via an SSL-encrypted transaction.
If you are working in a Jira Kanban board, Jira Epics will be marked as complete only if the issue is in the green “Done” column (or whatever you have renamed the last column).