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

# Slack

> Send updates and notifications to your Slack workspace with Gitar

export const ThemeImage = ({src, alt, width}) => {
  let lightSrc, darkSrc;
  if (src.includes("-light.")) {
    lightSrc = src;
    darkSrc = src.replace("-light.", "-dark.");
  } else if (src.includes("-dark.")) {
    darkSrc = src;
    lightSrc = src.replace("-dark.", "-light.");
  } else {
    lightSrc = src;
    darkSrc = src;
  }
  const style = width ? {
    maxWidth: width,
    marginInline: "auto"
  } : undefined;
  return <span>
      <img className="block dark:hidden rounded-lg border" src={lightSrc} alt={alt} style={style} />
      <img className="hidden dark:block rounded-lg border" src={darkSrc} alt={alt} style={style} />
    </span>;
};

## Overview

The Gitar Slack App posts pull request activity to your workspace, so your team follows code reviews and CI failures without leaving Slack. Gitar can post to a channel, send a direct message, and read Slack context back into a review.

<CardGroup cols={3}>
  <Card title="Channel Notifications" icon="hashtag">
    Send to public or private channels
  </Card>

  <Card title="Direct Messages" icon="user">
    Notify individual users
  </Card>

  <Card title="Context Retrieval" icon="download">
    Pull Slack context into reviews
  </Card>
</CardGroup>

## Connect Slack

<Steps>
  <Step title="Access Gitar Integrations">
    1. Go to your organization's **Settings** in the Gitar dashboard
    2. Open the **Integrations** section
    3. Find the **Slack** card under **Communication** and click **Connect**

    <ThemeImage src="/assets/images/integrations/slack-card-light.png" alt="Slack integration card in Gitar settings" />
  </Step>

  <Step title="Authorize the Slack App">
    Slack's authorization page opens.

    1. Select the workspace where you want to install the Gitar Slack App
    2. Click **Allow** to authorize the installation. The Slack card's button changes to **Configure** once the install completes

           <img src="https://mintcdn.com/gitar/55tETi2OXLxB8EgX/assets/images/integrations/slack-allow-app.png?fit=max&auto=format&n=55tETi2OXLxB8EgX&q=85&s=c7c48d6ec60968ba58b00589f93e9112" alt="Slack OAuth authorization page" width="1000" height="700" data-path="assets/images/integrations/slack-allow-app.png" />
  </Step>

  <Step title="Send Slack Notifications from PRs">
    Comment on a pull request with what you want sent and to whom, and Gitar sends it.

    **Channel reaction example:**

    <ThemeImage src="/assets/images/integrations/slack-channel-reaction-light.png" alt="Slack channel notification" />

    **Direct message example:**

    <ThemeImage src="/assets/images/integrations/slack-dm-light.png" alt="Slack direct message notification" />
  </Step>
</Steps>

## Using Slack in Rules

Name Slack in a custom rule and the agent picks it up, the same way it handles Jira or Linear. See [Rules](/features/rules) for how to write one.


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