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

# Sync Detail bugs with Linear, Jira, and Asana

> Publish Detail bug findings as issues or tasks in Linear, Jira, or Asana, with status sync so resolving an issue marks the bug as Resolved or Dismissed.

Connect Detail to Linear, Jira, or Asana to publish bugs as issues or tasks in your project management tool. Status changes sync back to Detail: when you close an issue in your tracker, Detail automatically marks the corresponding bug as Resolved or Dismissed.

## Connecting Linear

<Steps>
  <Step title="Open the integration settings">
    Go to **Settings → Integrations → Linear** in the Detail dashboard.
  </Step>

  <Step title="Authorize Detail">
    Click **Connect** and complete the OAuth flow. You'll be redirected to Linear to grant Detail access to your workspace.
  </Step>

  <Step title="Choose your default project">
    Select the default Linear workspace and project where Detail should publish bugs. You can override this on a per-bug basis when publishing.
  </Step>
</Steps>

## Connecting Jira

<Steps>
  <Step title="Open the integration settings">
    Go to **Settings → Integrations → Jira** in the Detail dashboard.
  </Step>

  <Step title="Authorize Detail">
    Click **Connect** and authorize Detail via Atlassian OAuth. You'll be prompted to log in to your Atlassian account if you aren't already.
  </Step>

  <Step title="Choose your default project">
    Select the default Jira project where Detail should create issues. You can override this per bug at publish time.
  </Step>
</Steps>

## Connecting Asana

<Steps>
  <Step title="Open the integration settings">
    Go to **Settings → Integrations → Asana** in the Detail dashboard.
  </Step>

  <Step title="Authorize Detail">
    Click **Connect** and complete the Asana OAuth flow.
  </Step>

  <Step title="Choose your default project">
    Select the default Asana workspace and project where Detail should create tasks.
  </Step>
</Steps>

## Publishing a bug to your tracker

To publish an individual bug, open its detail page and click **Publish**. Choose your destination tracker from the dropdown. The issue or task is created immediately and a link back to the Detail bug report is included in the description.

<Tip>
  You can publish multiple bugs at once from the main dashboard. Select the bugs you want using the checkboxes, then choose **Publish** from the bulk actions menu.
</Tip>

## Status sync

Once a bug is published, Detail keeps its status in sync with the linked issue or task automatically.

<CardGroup cols={3}>
  <Card title="Linear" icon="circle-dot">
    When you mark a Linear issue as Done (or any state mapped to resolved), the bug is automatically marked resolved in Detail.
  </Card>

  <Card title="Jira" icon="jira">
    When you resolve or close a Jira issue, Detail updates the linked bug state accordingly.
  </Card>

  <Card title="Asana" icon="list-check">
    Marking an Asana task complete automatically resolves the linked bug in Detail.
  </Card>
</CardGroup>