> ## 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}) => {
  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;
  }
  return <span>
      <img className="block dark:hidden rounded-lg border" src={lightSrc} alt={alt} />
      <img className="hidden dark:block rounded-lg border" src={darkSrc} alt={alt} />
    </span>;
};

## Overview

The Gitar Slack App enables your team to stay informed about pull request activity without leaving Slack. Get notifications on code reviews, CI failures, and other updates directly in your channels.

<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>

## Get Started

Follow these steps to connect your Slack workspace with Gitar.

<Steps>
  <Step title="Access Gitar Integrations">
    Navigate to your organization's settings in the Gitar dashboard to begin the integration:

    1. Navigate to your organization's **Settings** in the Gitar dashboard
    2. Go to the **Integrations** section
    3. Find the **Slack** card under **Communication** and click **Connect**

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

  <Step title="Authorize the Slack App">
    You'll be redirected to Slack's authorization page to approve the Gitar Slack App:

    1. Select the workspace where you want to install the Gitar Slack App
    2. Click **Allow** to authorize the installation

           <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">
    Once connected, you can ask Gitar to send Slack notifications directly from your pull requests. Simply comment on your PR with instructions for Gitar.

    **Channel reaction example:**

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

    **Direct message example:**

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