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

# Atlan

Elementary aims to meet business users where they live, so we believe it's important to allow anyone who uses data to
know whether the data is healthy quickly, easily and without any technical knowledge required. This is why we integrated with Atlan.

The integration works by pushing key insights to Atlan assets as custom metadata.
This metadata includes data health scores and open incidents, providing visibility into the quality and status of your
data.

![Elementary metadata in Atlan asset view](https://res.cloudinary.com/dvmtceykh/image/upload/v1733326078/image_21_ygrpno.png)

## How it works

1. You connect an Atlan tenant to an Elementary environment with a base URL and API token.
2. A regular sync writes health scores, incident links, and badges onto matching Atlan tables.

## Enabling Atlan

> [!NOTE]
>
> Connecting Atlan requires permission to edit integrations in Elementary.

**1. Create an Atlan API token**

In Atlan, create a persona (or reuse one) and generate an API token for Elementary.

Grant that persona:

* Assets: Read (search)
* Assets: Update
* Governance: Update custom metadata values
* Permission to create and update badges

Without write access to custom metadata and badges, the connection can succeed and the export will still fail.

**2. Add the connection in Elementary**

Go to **Settings → Environments**, select the environment, and click **Connect** on the **Data catalog** card.

![Data catalog integration in environment settings](https://mintcdn.com/elementary/0ZQkDk9KCcMPqWGg/pics/cloud/atlan-data-catalog-connect.png?fit=max\&auto=format\&n=0ZQkDk9KCcMPqWGg\&q=85\&s=85f8ca38557ff1925201e1ac5d34e44f)

Data catalog integration in environment settings

In **Connect Atlan**, paste the **Atlan base URL** (for example `https://your-company.atlan.com`) and **API token**. Click **Test connection**, then **Connect**.

Each environment can have one Atlan connection.

To replace an expired token, open **Edit Atlan connection**, paste the new token, test, and save. Disconnecting is not required.

If you install Elementary from the Atlan marketplace, generate an [account token](https://app.elementary-data.com/settings/account-tokens) and use that in Atlan. The token is shown once; revoke or rotate it from the same page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.