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

# Connect Slack for automatic Rationale audit summaries

> Connect Slack to receive audit summaries in a chosen channel. Each time a watched Figma file is saved, Rationale posts a fresh audit summary automatically.

Connecting Slack keeps your whole team informed about design changes without anyone needing to check Rationale manually. After connecting your workspace and choosing a channel, Rationale posts an audit summary to that channel every time a watched Figma file triggers a re-audit. You sign in once, pick the channel, and the notifications run automatically from that point on.

## What the Slack integration does

<CardGroup cols={2}>
  <Card title="Automatic audit summaries" icon="bell">
    Each time a watched Figma file is saved and Rationale completes a re-audit, it posts a summary to your chosen channel.
  </Card>

  <Card title="Choose your channel" icon="hash">
    After connecting, you pick the channel where audit results should be posted. You can change the channel at any time from connector settings.
  </Card>

  <Card title="Figma-triggered" icon="zap">
    Notifications are tied to Figma Watch. Every saved named version in a watched Figma file triggers a fresh audit — and a fresh Slack post.
  </Card>

  <Card title="One workspace, one connection" icon="plug">
    Sign in once with your Slack workspace. The connection applies to all projects that have Figma Watch enabled.
  </Card>
</CardGroup>

<Note>
  Slack notifications require Figma Watch to be active on at least one project version. If no Figma file is being watched, no notifications are sent. See [Watch for design drift](/workflows/match) to set up Figma Watch.
</Note>

## How to connect

<Steps>
  <Step title="Open Settings">
    Click **Settings** in the left sidebar.
  </Step>

  <Step title="Go to Connections">
    Select **Connections** from the settings menu.
  </Step>

  <Step title="Open the Slack connector">
    Click the **Slack** card.
  </Step>

  <Step title="Add the connector">
    Click **Add connector**. A Slack OAuth window opens.
  </Step>

  <Step title="Authorize your workspace">
    Sign in to Slack and select the workspace where you want audit summaries to be posted. Complete the authorization flow. The window closes automatically once the connection succeeds.
  </Step>

  <Step title="Choose a channel">
    After connecting, the connector settings show a **Post to channel** dropdown. Select the channel where audit summaries should be posted.
  </Step>
</Steps>

## How to change the channel

If you want to change which channel receives audit summaries, update the channel selection in connector settings.

<Steps>
  <Step title="Open Settings">
    Click **Settings** in the left sidebar.
  </Step>

  <Step title="Go to Connections">
    Select **Connections** from the settings menu.
  </Step>

  <Step title="Open the Slack connector">
    Click the **Slack** card.
  </Step>

  <Step title="Select a different channel">
    Use the **Post to channel** dropdown to choose a new channel. The change takes effect immediately — the next audit summary is posted to the new channel.
  </Step>
</Steps>

<Tip>
  Post to a dedicated channel such as `#design-audits` so audit summaries don't get lost in a busy general channel.
</Tip>

## How to disconnect

<Steps>
  <Step title="Open Settings">
    Click **Settings** in the left sidebar.
  </Step>

  <Step title="Go to Connections">
    Select **Connections** from the settings menu.
  </Step>

  <Step title="Open the Slack connector">
    Click the **Slack** card.
  </Step>

  <Step title="Disconnect">
    Click **Disconnect**.
  </Step>
</Steps>

<Note>
  Disconnecting removes the stored access token and stops all future Slack notifications. No historical messages in Slack are affected.
</Note>