Skip to main content
When you connect Unblocked with your Jira site, you’ll provide Unblocked with important context on how and why your codebase works. Most importantly, Unblocked will be able to use the Projects, Issues, and discussions your team has in your Jira site to answer questions you ask it, and it will provide links back to the information that it used for easy reference. Unblocked also reads sprint data from Jira’s custom fields, so you can ask about a named sprint, the current or active sprint, or which sprint an issue is in.

​
Data sync

Unblocked checks Jira for new and updated issues every 15 minutes. The first sync ingests your full project history; after that, syncs are incremental, so changes appear in answers shortly after they land in Jira.

​
Connect your Jira Site

If your organization has Data Shield enabled, we strongly recommend having a Jira admin connect your site. Doing so will ensure that Unblocked has the ability to sync Jira identities, removing the need for users to manually connect their account to receive answers containing Jira references.

​
Sign in to Unblocked

Whether you sign in with a source code manager or your SSO provider, you first need to authenticate to Unblocked. Once you’ve signed in, click Settings in the sidebar, then Data Sources. Click Connect Another, scroll to the issues section, and select Jira. You’ll then be redirected to Jira and asked to authorize your account with Unblocked.

​
Connecting Jira

Once you grant Unblocked access to your Jira site, you’ll be redirected back to Unblocked and prompted to install the Unblocked for Jira app if you are a Jira admin. After installing, return to the Unblocked tab and click Verify Installation to proceed to the Jira configuration page to select projects to share with Unblocked.

​
Selecting your Projects

You have the option to grant access to specific projects for Unblocked to index and search. You will be best served by granting access to all projects, but you can always restrict the scope depending on your team’s needs. Using Data Shield, you can also set access permissions that determine which content in your Jira projects will be used in Unblocked’s answers. Once you click Save Settings, Unblocked will begin referencing the issues in your Jira projects in its answers.

​
Troubleshooting

​
Unable to Connect Unblocked

If you see the following error message, it means user installed apps have been blocked for your site. To work around this, ask your Jira Admin to log in to Unblocked and connect your Jira Site. Alternatively, your Jira admin can temporarily allow user installed apps while you connect Unblocked to Jira. Ask your admin to visit your Jira site and click Apps > Manage apps. Then on the Settings tab of the Connected Apps page, click Allow user apps under the User Installed Apps section. You can now connect Unblocked to Jira. After connecting, your admin can re-enable blocking user installed apps.