> ## Documentation Index
> Fetch the complete documentation index at: https://graphite-58cc94ce.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Notifications

> Learn how to integrate Graphite with Slack to receive real-time, actionable notifications about your PRs.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/61b6128c-1688839902-notifs.png?fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=dcc683d0d35f0600590a69f0ffd868a0" width="5392" height="4210" data-path="images/61b6128c-1688839902-notifs.png" />
</Frame>

You have the ability to configure Slack notifications for PR activities like review requests, comments, mentions, and status changes. For some PRs, you can also approve, comment, request changes, or merge directly from Slack.

### Prerequisites

* A Slack workspace (free or paid)

## Install Graphite for Slack

Install the Graphite integration for Slack directly from the [notifications settings page](https://app.graphite.com/settings/notifications) on the Graphite app.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/9e707430-1688840382-screenshot-2023-07-08-at-2-19-27-pm.png?fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=b7bc33ac38e0b2d7abe9de6f6cf773ef" width="2328" height="588" data-path="images/9e707430-1688840382-screenshot-2023-07-08-at-2-19-27-pm.png" />
</Frame>

After adding your Slack workspace, you will be prompted to give the Graphite app permissions to proceed.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/1e2a70e0-1675699556-screenshot-2023-02-06-at-11-05-49-am.png?fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=1acbb3cd2603bcb96d6e7d94f091f074" width="1218" height="1162" data-path="images/1e2a70e0-1675699556-screenshot-2023-02-06-at-11-05-49-am.png" />
</Frame>

In the future, you can modify the Graphite App's access to select workspaces and channels through this settings page.

<Note>
  **Note**

  When there are major updates to our integration for Slack, we will sometimes prompt users to "re-install" the integration for their workspace. To do so, you can follow the exact same installation flow in this guide. No need to remove the existing integration—adding the integration again will override your previous one.
</Note>

## Set up real-time notifications

After you've installed the integration, you can enable real-time notifications in the [notifications settings page](https://app.graphite.com/settings/notifications) on the Graphite app. You can configure which types of events you want to receive notifications for.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/10bb323e-1688840928-notifs-settings.png?fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=d73642bf9a30b1b70c9b17f68ae373dc" width="3340" height="4210" data-path="images/10bb323e-1688840928-notifs-settings.png" />
</Frame>

### Reviewing and merging PRs from Slack

The Slack integration gives you the option to directly review and merge PRs from Slack. No extra setup is needed: simply enable Slack notifications for **Review requests** and **Activity on your PRs**. Reviewing from Slack is available for PRs of up to 25 lines.

### Privacy and authorization

For the purpose of providing personalized and configurable updates and information about code contributions, the Graphite app can:

* Send messages as **@graphite** in selected channels

* Start direct messages with people

* Upload, edit, and delete files as **Graphite**

* View files shared in channels and conversations that Graphite has been added to

* Add, edit, and delete remote files on a user’s behalf

* View remote files added by the app in a workspace

* Show previews of app.graphite.com URLs in messages

* View people in a workspace

* View URLs from app.graphite.com

<Note>
  You can only connect a Slack workspace to a single Graphite user account at once. If you have previously authorized the Slack workspace in a different Graphite user account, you will need to completely remove that Slack workspace from in that user account's [Notification settings](https://app.graphite.com/settings/notifications) before it can be authorized in another user account.

  <img src="https://mintcdn.com/graphite-58cc94ce/N1aRY7SRCeaXzTF2/images/remove-slack-example.png?fit=max&auto=format&n=N1aRY7SRCeaXzTF2&q=85&s=f22ae0fb4b70cc3476c460ba17870ffa" width="787" height="292" data-path="images/remove-slack-example.png" />
</Note>
