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

# Atlassian

<img src="https://mintcdn.com/dovetail-e5aa4160/mBnnLUvOcPIyGBHR/images/integrations/atlassian.png?fit=max&auto=format&n=mBnnLUvOcPIyGBHR&q=85&s=b6cfafedfd8f1cc817355d93cad1d931" alt="Atlassian Pn" width="1456" height="968" data-path="images/integrations/atlassian.png" />

# Overview

With our Atlassian integration, you can embed highlights and reels from Projects directly in Confluence, Jira, and Trello. You can also automatically import Jira issues into Channels in real-time, where they'll be automatically analyzed and classified into themes, allowing you to track trends over time.

[Learn more about Channels →](https://dovetail.com/help/channels/)

***

# Import Jira issues automatically to Channels

Connect Jira Service Management to Dovetail to sync support issues created in Jira into a Channel where they will be automatically stored, analyzed, summarized and organized into themes.

* To do this, open or create a new Channel for `Support tickets and` add `Jira` as a data source.
* Next, select the projects you wish to sync tickets from and how far back you'd like to import existing data from.
* From there, confirm set up and select `Finish`. Once complete, data from Jira will start importing into your Channel and continue to sync new tickets into your Channel when received in Jira.

<video autoPlay muted loop playsInline className="w-full" src="https://videos.ctfassets.net/8fl1jrx919na/6ZRDa1xXhHxCaLaGA4keEN/2bf4101c3179144714e33c66439f0f4a/Import_Jira_issues_Channels.mp4" />

***

# Jira permissions required

**1. Setting up the Jira integration**

* You must be a **Jira admin** (site or product admin level) to install and authorize the integration.

**2. Connecting Jira issues to a channel**

* You need the **Browse Projects** permission for the Jira project that contains the issue.
* This allows you to view and link issues to a channel in Dovetail.

**Note:**<br />In addition to Jira permissions, you’ll also need the appropriate access to the channel within Dovetail to complete the connection.

***

# Share highlight reels from Projects

<Warning>
  **This feature only works for Atlassian Cloud products.**
</Warning>

Embed a video or audio highlight or reel from a project by copying and pasting a link into a Confluence page, Jira issue, or Trello card. This video can be played directly in Confluence, Jira or Trello.

The Integrations Settings page does not start the Atlassian OAuth flow directly. You'll connect your account from within Jira, Confluence, or Trello instead.

To connect your Dovetail account:

1. In Jira, Confluence, or Trello, paste a Dovetail highlight or reel link, then select Connect your Dovetail account.
2. Choose your Dovetail workspace, sign in, and click Allow.
3. Atlassian exchanges the authorization code for access and refresh tokens. Your Settings card in Dovetail then shows as connected.

Once connected, your highlight or reel will unfurl, showing a preview you can watch directly in your tool.

Note: Jira app installation and authorization may require a Jira site or product admin. Dovetail workspace admins can view and revoke other users' connections; everyone else manages their own.

<video autoPlay muted loop playsInline className="w-full" src="https://videos.ctfassets.net/8fl1jrx919na/7ktBqOHwMOoCdulFPou8pJ/6409dafe90add11902f681d05efecebe/atlassian_unfurl.mp4" />

***

# FAQs

<AccordionGroup>
  <Accordion title="Why do I get stuck in a login loop when opening Dovetail previews in Confluence or Jira?">
    If you are repeatedly redirected to the Dovetail sign-in page, your browser may be blocking the pop-ups or redirects required for authentication. You will need to allow pop-ups and redirects for Dovetail in your browser settings.

    If the issue persists after allowing pop-ups and redirects, contact your IT team to confirm that browser security settings, extensions, or company policies are not blocking authentication between Dovetail and your browser.
  </Accordion>
</AccordionGroup>
