> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunblocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Connect your Jira projects to Unblocked

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.

## Connect your Jira Site

<Note>
  If your organization has [Data Shield](/team-settings/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.
</Note>

### 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.

<img src="https://mintcdn.com/unblocked/MWcrNY_CJjMR-SZM/img/Jira-authorize.png?fit=max&auto=format&n=MWcrNY_CJjMR-SZM&q=85&s=74783f6b5709fdd77e308df10fa8efd2" alt="Jira-authorize" width="2880" height="1820" data-path="img/Jira-authorize.png" />

### 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.

<img src="https://mintcdn.com/unblocked/MWcrNY_CJjMR-SZM/img/Jira-get-app.png?fit=max&auto=format&n=MWcrNY_CJjMR-SZM&q=85&s=f91ac8d81a5e833b310434310e3fbce2" alt="Jira-app" width="2880" height="1820" data-path="img/Jira-get-app.png" />

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](/team-settings/data-shield), you can also set access permissions that determine which content in your Jira projects will be used in Unblocked's answers.

<img src="https://mintcdn.com/unblocked/MWcrNY_CJjMR-SZM/img/Jira-projects.png?fit=max&auto=format&n=MWcrNY_CJjMR-SZM&q=85&s=b71c330fe1c2785cb4e87eae81658e55" alt="add-jira-projects" width="2880" height="1820" data-path="img/Jira-projects.png" />

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](https://getunblocked.com/dashboard/login) and connect your Jira Site.

<img src="https://mintcdn.com/unblocked/5UvV0EPrUga3COft/img/Atlassian-connect-error.png?fit=max&auto=format&n=5UvV0EPrUga3COft&q=85&s=f8f1715955c5d78fc50e052d873d7e43" alt="error" width="1876" height="518" data-path="img/Atlassian-connect-error.png" />

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**.

<img src="https://mintcdn.com/unblocked/5UvV0EPrUga3COft/img/Jira-manage-apps.png?fit=max&auto=format&n=5UvV0EPrUga3COft&q=85&s=032abc0c29a12bcf45b2ea8d31da837c" alt="Jira-manage-apps" width="2880" height="1820" data-path="img/Jira-manage-apps.png" />

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.

<img src="https://mintcdn.com/unblocked/5UvV0EPrUga3COft/img/Atlassian-allow-user-apps.png?fit=max&auto=format&n=5UvV0EPrUga3COft&q=85&s=edbbcb8a387be1e6b182a1f869e88092" alt="Atlassian-allow-user-apps" width="2880" height="1820" data-path="img/Atlassian-allow-user-apps.png" />

After connecting, your admin can re-enable blocking user installed apps.