---
title: "Slack"
description: "Connect your Slack workspace and optionally route channels to projects"
canonical_url: "https://hoplite.sh/docs/integrations/slack"
markdown_url: "https://hoplite.sh/docs/integrations/slack.md"
---

# Slack
URL: /docs/integrations/slack
LLM index: /llms.txt
Description: Connect your Slack workspace and optionally route channels to projects
Related: /docs/integrations, /docs/automations

# Slack

Connect Slack to bring Hoplite into the channels where your team already works.

## Setup

1. **Install** — under **Settings → Workspace → Integrations**, connect your Slack workspace. This authorizes the Hoplite bot for every project in the Hoplite workspace and installs the scopes it needs to read channel lists and post messages.
2. **Optionally route a channel** — under **Settings → Project → Connections**, choose a channel to route directly to a project. Channel selection is a picker over your actual Slack channels — no typing channel IDs by hand.

For a Slack message without a channel route, Hoplite uses the sole project when there is one, or a uniquely named project or repository in the request. When the request remains ambiguous, the requester chooses the project from a Slack dropdown. Existing Slack conversations remain linked to the project that started them even if their channel route is later changed or disabled.

## Make the app available to your workspace

The Hoplite Slack app must have **unlisted distribution** enabled before it can
be installed outside its Slack development workspace. In the Slack app
dashboard, open **Manage Distribution**, complete the **Share Your App with
Other Workspaces** checklist, then select **Activate Public Distribution**.
Publishing in the Slack Marketplace is not required.

If Slack shows `invalid_team_for_non_distributed_app`, the app has not yet been
distributed (or distribution was disabled). An app owner must activate
distribution, then start the connection again from Hoplite.

<Callout type="info" title="Reconnect after scope changes">
If the channel picker comes up empty on an older installation, reinstall the Slack app from workspace integrations — channel listing requires scopes that early installs may not have granted.
</Callout>

## Sitemap

See the full [sitemap](/docs/sitemap.md) for all pages.
Well-known sitemap: [/docs/.well-known/sitemap.md](/docs/.well-known/sitemap.md).