# Confluence integration

### Setting up the Integration

To configure the integration, follow these simple steps:

Navigate to the integrations page in aqua.\
Choose whether you'd like to set up the integration on a **global** or **project** level. Then on 'Confluence integration' tile click the 'Configure' button.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2F0B4ZU7Qav2EIBmq0iUBN%2Fimage.png?alt=media&#x26;token=81df4316-de8b-4d62-8de6-24deb5120ac9" alt=""><figcaption></figcaption></figure>

Once the modal appears, plese select whether you want to set it up for cloud or Data Center version.

&#x20;

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FdJ8PZ4zZ1x7xiYJcgOfB%2Fimage.png?alt=media&#x26;token=d64f796d-b407-4757-9dc8-80beac00279b" alt=""><figcaption></figcaption></figure>

### **Cloud version**

For Cloud version, first provide your Confluence website URL in the following format:

```
https://{website-name}.atlassian.net/wiki/
```

Then enter your Confluence user email and API key.

Click on **Check Connection** to verify your credentials. If all is good, click the 'Save' button.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FZwfm0YEnjwAUkXlQMgsN%2Fimage.png?alt=media&#x26;token=20d95f79-faeb-4410-b37b-acd324ff3493" alt=""><figcaption></figcaption></figure>

### **Data Center version**

For Data Center version, first provide your Confluence website URL in the following format:

```
https://{your domain}/
```

Then enter your PAT.

Click on **Check Connection** to verify your credentials. If all is good, click the 'Save' button.

### Linking Confluence pages

After successful setup open any aqua item and navigate to the **Dependencies** tab. Then click on the Confluence integration button located in the ribbon.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FllchnyeEWcl2vtarbepu%2Fimage.png?alt=media&#x26;token=dd2e8c55-3a63-40dd-a7c1-2662f4360338" alt=""><figcaption></figcaption></figure>

In the modal that appears, just paste the link to the Confluence page into the corrsponding field and click the 'Link' button.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FrX9E5OPFwkN4SugApNaT%2Fimage.png?alt=media&#x26;token=0e12b483-db21-49cf-8bed-fb0d49f636f7" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Please note that you always need to copy the URL from the browser, other links from Confluence are not supported
{% endhint %}

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2F1yx3DHP1snqfjNVNbVFJ%2Fimage.png?alt=media&#x26;token=d68eec6c-24d9-4109-9434-519000b7253b" alt=""><figcaption></figcaption></figure>

If you don't have the link, you can switch to the 'Search' tab and look for pages by a keyword or page title and select one or more pages to link by clicking next to each page.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FhGVjSKIQ8zl10V8HZUsz%2Fimage.png?alt=media&#x26;token=13a658c5-a575-4e0f-97fc-1110d31047a7" alt=""><figcaption></figcaption></figure>

Linked pages will be clearly displayed in both **graph** and **tree views**. Hovering over a linked page will reveal details such as the **owner** of the article and its **last modified date**.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FArxfZ9zFmjC3oAJlQC1A%2Fimage.png?alt=media&#x26;token=70f1ed91-c54f-4c54-b8a0-9697344dded1" alt=""><figcaption></figcaption></figure>

#### Unlinking Confluence Pages

To remove a link:

1. Hover over the linked page node.
2. Click the corresponding **unlink icon** that appears.

#### Current Limitations

Currently, this integration supports only Confluence **Cloud** pages.&#x20;

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FS0vHAAXLbJ2wwgdNyzS8%2Fimage.png?alt=media&#x26;token=82f82160-5231-43be-b56c-ae6512aaa29e" alt=""><figcaption></figcaption></figure>

Support for Confluence **Data Center** is planned for an upcoming release.