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

# Send Detail bug findings to Linear, Jira, and more

> Send Detail bug findings to Linear, Jira, Asana, GitHub Issues, Slack, or Email so your team tracks them alongside the rest of your work.

Detail can publish bug findings directly to your issue tracker — Linear, Jira, Asana, GitHub Issues, Slack, or Email — so your team sees them alongside other work. Publishing a bug creates a linked issue in the destination tool and keeps status in sync automatically, so you never need to manually update two places.

## Supported destinations

<CardGroup cols={2}>
  <Card title="Linear" icon="circle-dot">
    Creates a Linear issue in the project you configure. When you mark the Linear issue as done, Detail automatically updates the corresponding bug to `resolved`.
  </Card>

  <Card title="Jira" icon="atlassian">
    Creates a Jira issue in your chosen project. When you close a Jira issue, Detail automatically marks the corresponding bug resolved.
  </Card>

  <Card title="Asana" icon="check">
    Creates an Asana task in your chosen project. When you mark the task complete in Asana, Detail marks the bug resolved.
  </Card>

  <Card title="GitHub Issues" icon="github">
    Creates a GitHub issue in the scanned repository or in a separate target repository you configure. Useful for keeping bug tracking inside GitHub.
  </Card>

  <Card title="Slack" icon="slack">
    Posts the bug report as a Slack message to a channel you choose. Ideal for alerting your team to new critical findings without leaving their existing workflow.
  </Card>

  <Card title="Email" icon="envelope">
    Sends the bug report as an email. Useful for sending security findings to a security team distribution list or for stakeholders who don't use the dashboard.
  </Card>
</CardGroup>

## Connecting an integration

Before you can publish bugs, connect at least one destination in your account settings.

<Steps>
  <Step title="Open Settings → Integrations">
    In the Detail dashboard, click your organization name in the top navigation, then go to **Settings → Integrations**.
  </Step>

  <Step title="Connect your issue tracker">
    Click **Connect** next to the integration you want to enable. You'll be redirected to complete an OAuth flow that authorizes Detail to create issues on your behalf.
  </Step>

  <Step title="Choose a default destination">
    After authorization, select the default project, workspace, or channel where Detail should publish bugs. You can override this per-bug when publishing.
  </Step>
</Steps>

<Note>
  You can connect multiple destinations simultaneously. For example, you might send security vulnerabilities to a private Slack channel and all other bugs to a Linear project.
</Note>

## Publishing a bug

Once an integration is connected, publish any bug directly from the dashboard.

<Steps>
  <Step title="Open the bug detail view">
    Click on any bug in the findings list to open its full report.
  </Step>

  <Step title="Click Publish">
    Click the **Publish** button in the bug detail panel.
  </Step>

  <Step title="Select the destination">
    Choose where to send the bug from the list of connected integrations. If you have a default configured, it's pre-selected — change it here if needed.
  </Step>

  <Step title="Confirm">
    Click **Publish** to create the issue. Detail links the new issue back to the bug report so you can navigate between them in both tools.
  </Step>
</Steps>

After publishing, the linked issue appears in the **Linked Issues** section of the bug detail view, with a direct URL to the created issue.

## Status sync

When you update an issue in Linear, Jira, or Asana, Detail reflects that change automatically — no manual updates in the Detail dashboard required.

| Action in issue tracker                      | Effect in Detail            |
| -------------------------------------------- | --------------------------- |
| Mark a Linear issue as done                  | Bug moves to `resolved`     |
| Close a Jira issue as resolved               | Bug moves to `resolved`     |
| Complete an Asana task                       | Bug moves to `resolved`     |
| Reopen a closed Linear, Jira, or Asana issue | Bug moves back to `pending` |

If sync stops working, go to **Settings → Integrations** and click **Reconnect** next to the affected integration to restore it.

<Warning>
  Status sync is one-directional for Slack and Email — those destinations don't send status updates back to Detail. Resolve or dismiss Slack/Email-published bugs manually in the Detail dashboard.
</Warning>

## Bulk publishing

<Tip>
  You can publish multiple bugs at once using the bulk actions menu. In the findings list, check the boxes next to the bugs you want to publish, then click **Bulk actions → Publish** at the top of the list. Select your destination and Detail queues all selected bugs for publication in one step.
</Tip>