Setting up a Jira Full Sync integration for Jira Cloud
← Back to How ProdPad works with Jira
-
Availability
- Plan: Ideas Advanced
- On a legacy plan? Click here for more info
-
Roles and Permissions
- Add: Admin, Editor
- Edit: Integration Owner
- Delete: Integration Owner
Use our Jira content sync integration to create a link between your ProdPad Initiatives, Ideas and User stories and your Jira work items to update them when there is a change in either tool. Changes made in any ProdPad Initiative, Idea or User Story that is linked to a Jira work item will update instantly when the Sync updates to Jira button is used. However, due to the nature of the sync, any updates made in the Jira work item will take up to 15 minutes to reflect in the ProdPad Initiative, Idea or User Story. This article will discuss how to successfully set up the Jira Content Sync integration between ProdPad and Jira Cloud projects.
How to set up a Jira Content Sync integration
- Step 1: Create the integration
- Step 2: Connect your Jira account
- Step 3: Map Jira project and work items
- Step 4: Map ProdPad initiatives to Jira work items
- Step 5: Map Idea fields to Jira work item fields
- Step 6: Map ProdPad user story fields to Jira work item fields
- Step 7: Map Jira statuses to ProdPad Workflow stages
- Step 8: Sharing an integration
How to use the integration
Important!
Make sure to read the current capabilities and limitations for Jira Content Sync in our Jira Content Sync FAQ guide before creating your integration.
Step 1: Create the integration
Click on the Settings icon from the bottom left-hand side of the navigation bar.
Click Integration and then select Jira Cloud from the options Gallery.
You'll then be given the choice of integration you'd like to create. In this help article, we'll be setting up a Jira Full Sync integration, which you can find on the left-hand side of the selection menu. Once you've selected this option, click Next to move to the next step.
You'll then be prompted to give your integration a name - this is to help you and your team identify your integration, which is useful if you’re planning to set up multiple integrations to different Jira projects. When you're ready to move forward, click Connect.
Step 2: Connect your Jira account
After clicking Connect, you'll see an Atlassian account confirmation screen pop up. Once you've selected your account and accepted, the screen will close, and you'll return to ProdPad. Click Next to move on to mapping ProdPad to Jira.
Note: We have moved to OAuth 2.0 authentication, therefore it is no longer necessary to create app links for Jira Cloud integrations with ProdPad. However, if you have existing Jira integrations, it is best to leave the app link in place, as deleting may invalidate active tokens and break those integrations.
Step 3: Map Jira project and work items
This is the stage where you will choose which Jira project the integration will connect to, and dictate how information in ProdPad will map into Jira.
For the best results with this integration, if you are mapping intiatives, ideas and stories, we recommend is:
- A ProdPad Initiative = A Jira Epic
- A ProdPad Idea = A Jira Story or Task
- A ProdPad User story = A Jira Sub-task
For Ideas and User Stories only:
- A ProdPad Idea = A Jira Epic
- A ProdPad User story = A Jira Story or Task
Mapping Initiatives, Ideas and User Stories ensures a clear parent/child hierarchy between work items.
Read our guide for more info on mapping your work in ProdPad, and to get a sense of how Feedback, Initiatives, Ideas, User Story and Roadmap all relate to one another.
Step 4: Map ProdPad Initiatives to Jira work item fields
This step lets you define how Initiative fields in ProdPad map to Jira fields. You can also use the + Add mapping button to configure additional fields as needed. Once finished, click Next to continue.
Step 5: Map Idea fields to Jira work item fields
This is the stage where you set how Jira fields will map to Idea fields in ProdPad. Due to the continuous sync of data to ProdPad from Jira, the mapping should be one to one, i.e one Jira field maps to one ProdPad field. For convenience, the Idea fields will be automatically mapped depending on the Jira work item type option you selected for Ideas in the previous step, but the default mapping for these fields can be changed as required. You can click the + Add mapping button to map more fields for your ideas. Once you've finished setting up your mapping, click Next to proceed to the next stage of the integration setup.
Step 6: Map ProdPad user stories to Jira work item fields
Next up is mapping ProdPad user stories to Jira fields. As stated above, you can click the + Add mapping button to map more fields for your user stories. As with Ideas, the User Story fields will be automatically mapped depending on the Jira work item type option you selected for User Stories in the previous step, but the default mapping for these fields can be changed as required.
Step 7: Map Jira statuses to ProdPad Workflow stages
Lastly, you will configure how you want Jira statuses to reflect in your ProdPad Workflow. You can set a Jira status to map to multiple workflow stages. For example, if you have Jira statues like QA testing, UAT review, peer review - these could all map to one 'Testing' status in ProdPad.
Once the status mapping is done, click Activate. You'll also see the option to Start import and active next to the Activate button. This option allows you to import your Jira project work items into ProdPad and activate the integration at the same time. To learn more about importing Jira project work items into ProdPad, jump to the Importing from Jira section of this article.
Note: We currently do not provide status mapping for Initiatives.
Using the Jira Content Sync integration
Pushing from ProdPad to Jira
When pushing from ProdPad, you can select an Initiative, Idea, or User Story to send to Jira, depending on how your integration is configured. Initiatives will push as Epics, Ideas as Stories, and User Stories as Sub-tasks (based on the mappings you set up). If you have you Ideas and Stories linked to initiatives you can push them all together!
Pushing an initiative from ProdPad to Jira
When you have an initiative that is ready to be pushed to Jira and kickstart your development project, go to your Roadmap and find the Initiative. Open the Initiative canvas, scroll to Integrations and click Push
This will open up a module window where you can choose to push the Initiative via the Jira integration you've set up.
You will also have the option to push over Ideas and User Stories. If you choose to do so, any associated Ideas and User Stories will be pushed to Jira as work items according to your mapping and associated with the Epic that the Initiative becomes (assuming the work item type selected for the Jira integration is Epic).
If you have any required fields, you will be asked to enter them before pushing.
There will now be a link to the Jira ticket in the Integrations section on the Initiative. The ticket in Jira will also link back to the ProdPad Initiative. To quickly navigate to the linked work item in Jira, simply click the link in the ProdPad Initiative (also to note, you can click the link in the Jira work item to navigate back to the linked ProdPad Initiative too!).
If you make any changes to your Initiative in ProdPad simply click Sync updates to Jira to push those changes over.
Pushing an idea from ProdPad to Jira
Head to your Ideas list, and pick an idea that's ready for development. On the Idea Canvas page, click on Push.
This will open up a module window where you can choose to push the Idea via the Jira integration you've set up.
You will also be prompted to push over user stories. If you choose to do so, any associated user stories will be pushed to Jira as stories and associated with the Epic that the Idea becomes (assuming the work item type selected for the Jira integration is Epic).
If you have any required fields, you will be asked to enter them before pushing.
There will now be a link to the Jira ticket in the Integrations section at the top of the Idea. The ticket in Jira will also link back to the ProdPad Idea. To quickly navigate to the linked work item in Jira, simply click the link in the ProdPad Idea (also to note, you can click the link in the Jira work item to navigate back to the linked ProdPad Idea too!).
From now on, any changes to the linked work item's status in Jira will automatically update the Idea workflow stage in ProdPad – such Ideas will be marked with a blue banner with a Jira logo on it.
If you make any changes to a pushed Idea or User Story in ProdPad, you'll notice the Push button on the Idea canvas changes to Sync updates to Jira. Clicking this button after you make changes to a pushed Idea will update the linked work item in Jira instead of creating a separate new work item. The updated changes will be reflected in the Jira work item immediately when the Sync updates to Jira button is pushed. However, due to the nature of the sync, any changes made to the Jira work item can take up to 15 minutes to appear in the linked ProdPad Idea or User Story.
How to Pause and Resume Jira Sync
You can pause sync for Ideas, or User Stories. The process is the same for all types — pausing will unlock fields for editing in ProdPad while suspending sync with Jira. Resuming will push your changes back to Jira and re-lock fields.
[Rest of existing “pause” section unchanged…]
Importing from Jira
You can import Jira Epics, Stories, and Sub-tasks into ProdPad as Initiatives, Ideas, and User Stories respectively, once a Jira Content Sync integration is set up.
[Rest of existing “import” section unchanged…]
Sharing an integration
[Unchanged existing content…]