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

# Jira

> Turn every Jam into a fully loaded Jira issue. Console logs, network requests, and device info are attached automatically.

<iframe src="https://www.youtube.com/embed/XckdhyMpbeo" width="100%" height="400" allowFullScreen />

You can connect Jira and Jam to instantly create Jira tickets right from Jam's browser extension.

<Info>You need the Jam Chrome extension installed. See [Getting Started](/introduction) if you haven't set it up.</Info>

## What's included in every Jira issue

Every Jira issue created from Jam automatically includes:

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

<Tabs>
  <Tab title="Create a Jira issue from a new capture">
    <Steps>
      <Step title="Capture your bug">
        Use the Jam browser extension to capture your bug.
      </Step>

      <Step title="Select Jira as the destination">
        In the Jam extension, click **Link you can share** and change the destination to Jira.
      </Step>

      <Step title="Authenticate with Jira">
        Complete the Jira OAuth flow to connect your account.
      </Step>

      <Step title="Configure your Jira issue">
        Once connected, set up your issue directly from Jam: choose the project, issue type, priority, labels, and more.
      </Step>

      <Step title="Create the issue">
        Click **Create issue**. Jam creates the Jira ticket and opens it in a new tab.
      </Step>
    </Steps>

    <Tip>
      Click **Edit fields** during issue setup to control exactly which Jira fields appear in the Jam extension. Hide fields you never use to keep the workflow fast.
    </Tip>
  </Tab>

  <Tab title="Send an existing Jam to Jira">
    Create a Jira issue from any Jam you've already captured in two clicks.

    <Note>
      You must be logged into Jam to use this feature. Logged-out users will not see the **Send to App** option.
    </Note>

    <Steps>
      <Step title="Open the Jam">
        Open the Jam you want to convert into a Jira issue.
      </Step>

      <Step title="Click Send to App">
        Click **Send to App** and select Jira.
      </Step>

      <Step title="Log in to Jira if prompted">
        If this is your first time using Jam + Jira, you'll be redirected to authenticate.
      </Step>

      <Step title="Fill in the issue details">
        Enter the project, issue type, priority, labels, and any other fields you need.
      </Step>

      <Step title="Create the issue">
        Click **Create issue** to send the Jam to Jira.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Connect multiple Jira sites">
    Each Jam workspace connects to one Jira site. To work with multiple Jira sites, for example across different clients or companies, create a separate Jam workspace for each one.

    <Steps>
      <Step title="Go to the Jam dashboard">
        Open [jam.dev](https://jam.dev).
      </Step>

      <Step title="Create a new workspace">
        Click **Invite Members** or **Add a Workspace** and follow the prompts.
      </Step>

      <Step title="Connect Jira">
        Go to [**Settings → Integrations**](https://jam.dev/s/settings/integrations) and click **Jira**. The Jira OAuth flow opens in a new tab.
      </Step>

      <Step title="Select the Jira site">
        Choose which Jira site to connect to that workspace.
      </Step>

      <Step title="Repeat for each Jira site">
        Repeat this process for every Jira site you need to connect.
      </Step>
    </Steps>

    ### Swap a connected Jira site

    To switch which Jira site is connected to a Jam workspace:

    <Steps>
      <Step title="Disconnect Jira">
        Go to [**Settings → Integrations**](https://jam.dev/s/settings/integrations) and disconnect Jira.
      </Step>

      <Step title="Revoke Jam access in Atlassian">
        Go to [id.atlassian.com/manage-profile/apps](https://id.atlassian.com/manage-profile/apps), find Jam, and click **Remove access**.
      </Step>

      <Step title="Reconnect to the new Jira site">
        Return to [**Settings → Integrations**](https://jam.dev/s/settings/integrations) and reconnect.
      </Step>
    </Steps>
  </Tab>
</Tabs>