Integrating ProductPlan with Jira is typically seamless and easy. In some cases, ProductPlan may have trouble communicating with Jira so we've put together a few things you can try.
Authorization
Note: If this is the first time someone on your team is configuring the integration please be sure that a Jira Admin first follows Step 2 in our configuration steps listed here.
Error after Step 1:
Jira Cloud
The Jira URL you entered may be incorrect.
Your organization may have IP Allowlisting security in place. Please work with your Jira administrator to enable the proxy and allow our IP addresses (noted above). Please also see this Jira article for more information.
A server may be down and you need to try again later.
A request times out. Please wait a few minutes and try again.
Jira Server or Data Center
The Jira URL you entered may be incorrect.
Our IP Addresses (noted above) must be allowlisted on your organization's firewalls. Please connect with your Jira administrator and IT team for assistance.
Your firewall needs to be configured to correctly route traffic to your Jira server.
A request times out. Please wait a few minutes and try again. If the problem persists, please contact your IT team for assistance.
Your server may be down or was made inaccessible over the internet
Error after Step 2:
"We were unable to connect your Jira application. This could be because you have not configured your Jira application or because your Jira endpoint is not typed correctly. Please try again, or contact support if you are having trouble"
To fix this error, follow these steps:
First, check to be sure that you copied the Incoming Authentication Key in its entirety. You may need to scroll to the bottom of the modal in Jira to see all fields.
If you are still receiving an error message and you can confirm that the Incoming Authentication Key is correct, please be sure to double-check your Jira URL is correct: http://yourcompany.atlassian.net
Public Key is Invalid:
After entering in the Public Key, you may receive an error message that says:
"ProductPlan" (Generic Application) is not registered as a service provider and "JIRA" (JIRA) cannot make requests using OAuth
."
To fix this error, follow these steps:
Make sure you have admin access to Jira
Double-check that your Jira URL is correct
Be sure that you copied the whole entire Public Key (including the beginning and end certificate).
Percent Complete
Scenario: "My bar in ProductPlan is showing that it is X% complete, but in Jira the epic is 100% complete. I've tried refreshing in ProductPlan and it's still showing X%."
To fix this error, follow these steps:
We use Resolution Field to calculate percent complete, so first be sure that the “Resolution” field is set to a done type state (typically it will be called “Done” but it can have different names). Sometimes the issue is that your team may have configured JIRA in a customized way (e.g. using the Resolution field for something else). If it is, it will be counted towards completion.
Note: The Status field is not the same as Resolution field and we can calculate Percent Complete based on all Issue Types: (Story, Bug, Task etc. except for Sub-Tasks).
If it's still not updating, check your integrations page. You can set percent complete to Story Points or Number of Stories - please make sure you're mapping to the correct field.
Date Syncing
Date Syncing Scenario: “None of my dates are syncing correctly from Jira to ProductPlan.” or “Every time I sync my roadmap the date locks break.”
To fix this error, please check if any of the situations below apply to you and adjust accordingly:
First check to see if your Jira dates are outside the range of the main roadmap timeline date range.
If you change the date mappings on your ProductPlan Integrations page for items currently on your roadmap syncing with Jira then this could break the lock as well.
If the child bars in a container have Jira sync dates that will place them outside the start/end date of the parent container, the child bar(s) date sync lock will be broken and the bars will not move.
If you are working on a roadmap that you are not the owner of, and the roadmap owner does not have Jira dates configured, the sync will not work.
Verify that you have the correct date fields syncing; sometimes teams are under the assumption they're utilizing a "due date" field for "end date", but may actually be using some other title, like "complete date", etc.
If the roadmap owner imports issues from multiple projects that have different start/end dates then it will only sync dates for the projects that have the same dates as the mapped fields. For items in different projects with different dates it will sync title, description and percent but not dates.
Lane/Legend Syncing
Lane Syncing Scenario: “None of my lanes are syncing correctly from Jira to ProductPlan.” or “Every time I sync my roadmap the lane locks break.”
Legend Syncing Scenario: “None of my legend labels are syncing correctly from Jira to ProductPlan.” or “Every time I sync my roadmap the legend locks break.”
To fix this error, please check if any of the situations below apply to you and adjust accordingly:
If you change the roadmap-specific fields on your ProductPlan Integrations page for items currently on your roadmap syncing with Jira then this could break the lock as well.
If you are working on a roadmap that you are not the owner of, and the roadmap owner does not have Jira lanes/legends configured, the sync will not work.
Verify the lane and legend fields you'd like to appear in ProductPlan are from custom drop-down fields in Jira.
FAQ
I want to use multiple Jira projects but it's only allowing me to choose one upon configuration?
You can choose more than one Jira project later on, we just need you to choose one to start so you can choose which fields you'd like mapped from Jira to ProductPlan. When importing or syncing, you can then choose multiple projects, and it will only pull those fields that you pre-selected.
I've chosen a project to connect Jira to ProductPlan, why can't I choose "sync now"?
After you have chosen a project, and chosen which fields you want mapped from Jira to ProductPlan, you will then want to Import items into your Parked Section of your Table Layout before you can Sync.
What happens if I import items from Jira or sync items on a roadmap that I am not the owner of?
You do not need to be the owner of a roadmap in order to import or sync with items from Jira. However, keep in mind that we will always use the roadmap’s owners field mappings as the source of truth for the sync. You can review the field mappings for your roadmap by clicking on Roadmap Settings, then navigating to the Integrations section. Please note that Jira allows for two fields to have the same label, so further troubleshooting may need additional assistance from your Jira Administrator.
In some unique cases, your Jira instance may be set up differently than others. So if you find that you are still experiencing issues, please don't hesitate to reach out to our team at support@productplan.com.