In some circumstances, productboard may not be able to communicate with Jira. Follow the tips below to resolve any issues and please let us know if you experience any issues not listed below.
⚠️ Invalid Jira server SSL certificate
productboard requires that all J servers have valid SSL certificates. If yours is invalid, a small update may be all you need to be on your way.
See what's causing the issue using a utility like this SSL Server Test.
⚠️ Check Jira screen settings (missing reporter)
You'll need to log in as a user with the J Administrators global permission.
In your Jira account, head to any open issue (or create a test one if you'd like). Click to Edit the issue. From the pop up panel, click on Configure Fields > Custom. Then ensure that the Reporter box is checked.
You can also complete this action for multiple projects at once by heading to Jira settings > Issues > Field Configurations (Default). From there, scroll to Reporter and select the Screens button next to Edit. Please check the boxes for all of the projects you'd like to connect to productboard and click Update.
For more help, refer to the Jira help article Defining a Screen.
⚠️ We are not able to connect with your Jira project. Try reauthorizing access.
Someone may have removed the application link to productboard in Jira. To get back up and running, reauthorize the Jira integration.
Frequently asked questions
❓ How do I add a Jira administrator?
Follow these steps:
- Go to Settings › Projects.
- Choose the project you have connected to productboard.
- Under 'People' click 'Add People'
- Add the project admin
❓I'm the user who push the ticket (reporter) but in Jira it still appears as someone else
- Check your user permissions in Jira.
- If you don't have a role in Jira it will default to the Project Lead.
- Check if your email address matches both accounts.
- Check if you are the Feature owner in productboard for the ticket.
❓Why can't I push some features 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 story 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.
❓How can I 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.
❓Our previous Jira owner has left the company. What do we do?
Once you've transfered ownership in Jira, you'll need to reauthorize the Jira integration in productboard.
If you don't see a Reauthorize option on your J settings page in productboard, reach out to a member of our team for assistance.
❓Why can't I access some Jira projects or Jira issues from the Jira integration?
It might be a permissions issue on the Jira side of the integration, with the user who setup the integration not having "Jira Administrator Global Permissions" on the Jira side, and thus not having access to all projects or issues (most likely through a particular group they were not a member of in Jira).
Help! I tried to set up my Jira on-prem integration, and it says the address doesn't exist/is unavailable/there was a timeout!
Your Jira on-prem setup needs to be in a public network, with a public IP address, for the Jira integration to work. The IP address can be inaccessible from the Internet generally, but made accessible to Productboard.
If you are encountering these errors after following our instructions, reach out to your system administrator with the information above.