# Source: https://jam.dev/docs/integrations/jira.md

# Jira

{% embed url="<https://www.youtube.com/watch?v=XckdhyMpbeo>" %}

You can connect Jira and Jam in order to instantly create Jira tickets right from Jam's browser extension. Every Jira ticket you create with Jam automatically includes:

* Console logs
* Fully inspectable network requests
* URL, timestamp and country
* Device, OS, Browser
* Viewport size
* Network speed

That way, it's perfect for engineers to help them debug issues faster.

You can configure all the relevant Jira fields right from Jam – like assignee, labels, priority and more. Our goal is to make you 20x faster at logging bugs to Jira.

## How to use Jam + Jira&#x20;

1. First, you'll need to make sure you have Jam installed in your browser. Follow our Jam getting started guide here if you haven't downloaded and setup Jam yet:

&#x20;     [getting-started](https://jam.dev/docs/get-started/getting-started "mention")

2. Next, capture your bug with Jam. <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FKudedVPREisJzX7GrzyP%2Fjira-1.gif?alt=media&#x26;token=75708029-5c79-4411-9bea-f71e76381873" alt="" width="375"><figcaption></figcaption></figure></div>
3. In the Jam extension, you will have the option to choose where Jam sends your screen capture to. Click on "Link you can share" and change it to Jira.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FPfcfW47vuBdY3begN3ny%2Fjira-2.gif?alt=media&#x26;token=880aef86-4992-447c-aa7e-0ab193fafab4" alt="" width="375"><figcaption></figcaption></figure></div>
4. Jam will guide you through authenticating with Jira.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2F6Sa20OJCkeAbXVkz3QKh%2Fjira-3.gif?alt=media&#x26;token=8698b8a2-46fe-4d73-877f-fef0f26dd036" alt="" width="375"><figcaption></figcaption></figure></div>
5. Once Jam is connected to Jira, you will be able to setup your Jira ticket right from Jam.\
   Choose the project, issue type, priority, labels, etc., right from Jam. <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2Fk88R9HqBIDvVEZH2TNGA%2Fjira-4.gif?alt=media&#x26;token=1754ee06-2ddc-4e1f-9407-1956ba7442b6" alt="" width="375"><figcaption></figcaption></figure></div>
6. Pro tip: you can click "Edit fields"  to manage which fields from Jira are shown in Jam:<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FYzhUdew0ORRAp7IGh5PX%2Fjira-5.gif?alt=media&#x26;token=c5452a99-3d1d-4c97-b771-ea228d3f32dc" alt="" width="375"><figcaption></figcaption></figure></div>
7. Click "Create issue" and once Jam creates your Jira ticket, it will automatically open in a new tab. <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FOJo2Wlq17GBRTJ53atjt%2Fjira-6.gif?alt=media&#x26;token=d86aa14e-bb2b-4f2d-8592-d138b46cbf7c" alt="" width="375"><figcaption></figcaption></figure></div>

## How to send existing Jams to Jira

You can automatically create Jira tickets from existing Jams – in just 2 clicks.

*Note: You must be logged into Jam to use this feature. Logged out users will not see this option.*

1. Open up the Jam you want to convert to a Jira ticket.
2. Click "Send to App" and select Jira.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FCNC622gdECxbxwUSL8gF%2Fjira-tools-1.gif?alt=media&#x26;token=c03eeded-9ba4-45b8-9c5e-a31e64574844" alt="" width="375"><figcaption></figcaption></figure></div>
3. If you have not used Jam + Jira before, it will first redirect you to log in with Jira.
4. Enter the details of your Jira ticket: project, issue type, priority, labels, etc<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FbjlOhE3XHZYMDTmbHRgs%2Fjira-tools-2.gif?alt=media&#x26;token=0aa1ddc3-293b-4245-ab46-b7f2be3e752e" alt="" width="375"><figcaption></figcaption></figure></div>
5. Pro tip: you can click "Edit fields"  to manage which fields from Jira are shown in Jam.
6. Click "Create issue" to create your Jira ticket.&#x20;

## How to connect multiple Jira sites to Jam

Each Jam team workspace can connect to one Jira site. That means if you're working with multiple companies or clients where each one uses its own Jira site, you will need to create a new Jam team workspace for each company/client, and connect each Jam team workspace to the relevant Jira site for that company/client.

Here's how to create multiple Jam team workspaces and connect them to separate Jira sites:

1. Go to the Jam dashboard: [jam.dev](https://jam.dev)
2. Click "Invite Teammates" or "Add a Team" <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2F1UIMx7obwBDvjUTs8ysJ%2Fteam-1.gif?alt=media&#x26;token=426fb51c-ce7b-43c2-806c-1d878fa3d516" alt="" width="316"><figcaption></figcaption></figure></div>
3. Jam will walk you through the steps of creating a team.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FjUlv1G9GMruXJkn4EBHd%2Fteam-2.gif?alt=media&#x26;token=64c0f45d-d123-488f-b01c-d5a934cd66b2" alt="" width="375"><figcaption></figcaption></figure></div>
4. Go to your newly created team settings. Click on "Connected Apps". Then click on "Jira". The Jira authentication flow will open in a new tab. <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FUFFntrOD2oKIdiFO2zCq%2Fjira-team-1.gif?alt=media&#x26;token=6ae34728-43b3-4eb9-9369-0f966f9e3e41" alt="" width="375"><figcaption></figcaption></figure></div>
5. Select the Jira site you want to connect to.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2F9d3mIo2WFkiRWIyPT5P9%2Fjira-team-2.gif?alt=media&#x26;token=4ff40e36-d6df-4832-90f1-7e60b0376d79" alt="" width="375"><figcaption></figcaption></figure></div>
6. After you are done connecting to Jira, you will be able to see which Jira site is connected to that Jam team workspace.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2F4HvlSNyyqakCoifMpwp6%2Fjira-team-3.gif?alt=media&#x26;token=733d37d6-297b-45f3-a187-1cb2b9a7f240" alt="" width="375"><figcaption></figcaption></figure></div>
7. Repeat this process of creating a new Jam team workspace + connecting the corresponding Jira site for every Jira site you need to connect to Jam.&#x20;

If you need to swap which Jira site is connected to a Jam team, follow these 3 steps:

First, you will need to disconnect Jira from the Jam team settings.&#x20;

Then you will need to login to Jira and disconnect Jam by going to  <https://id.atlassian.com/manage-profile/apps>, finding Jam, and clicking on "Remove access".&#x20;

Finally, you can go back to the Jam settings page and re-connect Jam to the new Jira site.

<div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FkrUcMqa19RPuXb9xtcDJ%2Fimage.png?alt=media&#x26;token=031e2a55-4a4f-495d-a9e9-7fe259078122" alt="" width="479"><figcaption></figcaption></figure></div>