## What does Atlan do with each Slack permission?

URL: https://docs.atlan.com/product/integrations/collaboration/slack/faq/slack-permissions

> Learn about what does atlan do with each slack permission?.

As you set up the [Slack integration](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt), you will need to provide an Atlan Slack app permissions in Slack. Note the following:

- Atlan does not store any data for Slack messages. Slack messages are fetched on demand.
- Atlan connects to Slack via Slack APIs, and stores the following metadata to send messages on behalf of users - username, channel name, tenant name, refresh token, and access token.
- Atlan does not store any personally identifiable information of users.

Here is what Atlan does with each of those permissions:

## What will Atlan be able to view?

### Content and info about you

- View profile details about people in your workspace ([`users.profile:read`](https://api.slack.com/scopes/users.profile:read))
- View information about your identity

Atlan requires these permissions to:

- Show rich Slack message previews within Atlan (for example, a user's profile picture)

### Content and info about channels & conversations

- View messages and other content in your public channels ([`channels:history`](https://api.slack.com/scopes/channels:history))
- View basic information about public channels in your workspace ([`channels:read`](https://api.slack.com/scopes/channels:read))
- View Atlan URLs in messages ([`links:read`](https://api.slack.com/scopes/links:read))
- View messages and other content in public channels that Atlan has been added to ([`channels:history`](https://api.slack.com/scopes/channels:history))

Atlan requires these permissions to:

- Show rich Slack message previews within Atlan (the message itself, the channel where it was posted)

### Content and info about your workspace

- View people in your workspace ([`users:read`](https://api.slack.com/scopes/users:read))
- View profile details about people in your workspace ([`users.profile:read`](https://api.slack.com/scopes/users.profile:read))
- View email addresses of people in your workspace ([`users:read.email`](https://api.slack.com/scopes/users:read.email))

Atlan requires these permissions to:

- Show rich Slack message previews within Atlan (for example, a user's profile picture)
- Send notifications about requests made in Atlan ([`users:read.email`](https://api.slack.com/scopes/users:read.email))

## What will Atlan be able to do?

### Perform actions in channels and conversations

- Show previews of Atlan URLs in messages ([`links:write`](https://api.slack.com/scopes/links:write))
- Send messages as `@atlan` ([`chat:write`](https://api.slack.com/scopes/chat:write))
- Send messages to channels `@atlan` isn't a member of ([`chat:write.public`](https://api.slack.com/scopes/chat:write.public))
- Add and edit emoji reactions
- View messages that directly mention `@atlan` in conversations that the app is in
- Upload, edit, and delete files as Atlan ([`files.write`](https://api.slack.com/scopes/files:write))

Atlan requires these permissions to:

- Unfurl Atlan links (show previews for them) within Slack
- Allow the Slack share button on Atlan assets to work (sending messages to Slack as `@atlan`)
- Search Atlan from any Slack channel and share search results to the channel, all from within Slack
- Share query output from within Atlan to Slack ([`files.write`](https://api.slack.com/scopes/files:write))

### Perform actions in your workspace

- Add shortcuts and/or slash commands that people can use ([`commands`](https://api.slack.com/scopes/commands))

Atlan requires these permissions to:

- Search Atlan from within Slack (the `/search-term` and `/search-query` commands)
- Document a Slack conversation into Atlan (using the Slack context menu on any Slack conversation)

---