# Reinstall Slack App

Sometimes Dot's Slack app needs to be reinstalled — for example, when we update the app's permissions or fix a configuration issue. This guide walks you through the process step by step.

{% hint style="info" %}
Reinstalling the app does **not** delete your chat history or any data in Dot. It only resets the Slack connection.
{% endhint %}

## Before You Start

**Note which channels Dot is currently in.** After reinstalling, Dot will need to be re-added to each channel manually.

You can find the full list on the Dot app's configuration page in Slack (see Step 1) — it shows all channels under **Bot user**:

<figure><img src="https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2Fgit-blob-6ab1421f11b83e3f767930904a2a7ff62295996b%2Fslack-reinstall-remove-app.png?alt=media" alt="The Slack app configuration page showing which channels Dot is in and the Remove App button"><figcaption><p>The Bot user section lists all channels Dot is currently in. Note these down before removing.</p></figcaption></figure>

{% hint style="warning" %}
Only **Slack Workspace Owners** and users with app management permissions can remove and install apps.
{% endhint %}

## Step 1: Remove the Dot App from Slack

1. In Slack, click your **workspace name** in the top-left corner
2. Go to **Tools & settings** → **Manage apps**
3. Click **Apps** in the left sidebar and find **Dot**

<figure><img src="https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2Fgit-blob-f11c090461218be9758c5504ec9680911dd0d4ea%2Fslack-reinstall-apps-list.png?alt=media" alt="Slack Apps page showing Dot in the list"><figcaption><p>Find Dot in your installed apps.</p></figcaption></figure>

4. Click on **Dot**, then click **Configuration**

<figure><img src="https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2Fgit-blob-274a13d93c2066eeaba00b729e0e009be18cfbe1%2Fslack-reinstall-app-detail.png?alt=media" alt="Dot app detail page with Configuration link"><figcaption><p>Click Configuration to open the app settings.</p></figcaption></figure>

5. Scroll down to **Remove app** and click **Remove app**
6. Confirm the removal when prompted

## Step 2: Reinstall Dot via Settings

1. Go to [Dot Settings](https://app.getdot.ai/settings)
2. Click on the **Slack** integration
3. Click **Add Dot to Slack**

<figure><img src="https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2Fgit-blob-f6185d9bf9122ae0276f0decda8ca924892d964f%2Fslack-reinstall-dot-settings.png?alt=media" alt="Dot Settings page showing the Slack integration panel"><figcaption><p>Click "Add Dot to Slack" to start the reinstallation.</p></figcaption></figure>

4. In the Slack authorization screen, select the channel where Dot should respond by default and click **Allow**

## Step 3: Re-add Dot to Your Channels

After reinstalling, Dot is only in the default channel you selected during installation. You need to manually re-add Dot to any other channels it was previously in.

To add Dot to a channel:

1. Open the Slack channel where you want Dot
2. Type `/invite @Dot` in the message field and press Enter

Repeat this for every channel from your list in the "Before You Start" step.

{% hint style="info" %}
You can also add Dot to a channel by typing `@Dot` in the channel — Slack will prompt you to invite the app.
{% endhint %}

## Troubleshooting

### Dot doesn't appear in the install screen

Make sure the previous app was fully removed from Slack (Step 1). If the old installation is still active, the reinstall may not work correctly.

### Dot isn't responding in a channel

Verify that Dot has been invited to the channel (Step 3). Dot can only respond in channels where it has been explicitly added.

### Permission errors during install

Contact your Slack Workspace Owner — they may need to approve the Dot app before it can be installed.