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

# Connect Your Slack Workspace

> Learn how to connect your Slack workspace to Confidence and manage its permissions.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<HowToSchema
  name="Connect Your Slack Workspace"
  description="Connect Slack to Confidence for notifications and conversations with the agent."
  steps={[
{
  name: "Open the Slack integration",
  text: "In Confidence, go to Admin > Integrations > Slack.",
},
{
  name: "Connect Slack",
  text: "Select Connect Slack, choose your Slack workspace, and approve the requested permissions.",
},
{
  name: "Complete the connection",
  text: "Sign in to Confidence and check the connection result.",
},
]}
/>

Connect your Slack workspace to receive notifications and use Confidence from Slack. See [Use Confidence in Slack](/docs/guides/use-confidence-in-slack) for examples.

The workspace connection installs the Confidence app. Then follow [Add Confidence to a Slack Channel](/docs/platform/notifications/add-confidence-to-slack-channel) for each channel where you want to add the agent.
For personal notifications, each user can follow [Personal Slack Notifications](/docs/platform/notifications/connect-personal-slack).

## Before You Begin

You need:

* Permission to manage Slack integration in Confidence.
* Permission to install apps in your Slack workspace. Your organization might require a Slack administrator's approval.

Anyone using the agent also needs access to the connected Confidence workspace.

## Connect Slack

<Steps>
  <Step title="Open the Slack integration">
    In Confidence, go to **Admin > Integrations > Slack**.
  </Step>

  <Step title="Approve the Slack permissions">
    Select **Connect Slack**. Choose your Slack workspace and approve the requested permissions.

    If Slack requires administrator approval, ask your administrator to approve the app and its permissions.
  </Step>

  <Step title="Complete the connection">
    Sign in to Confidence and check the connection result.
  </Step>
</Steps>

## Check the Connection Result

<Tabs>
  <Tab title="Connected">
    **Slack connected** confirms which Slack workspace and Confidence account you connected.

    <Frame caption="A completed connection to the Flag Club account.">
      <img src="https://mintcdn.com/confidence-7c0fec1b/rWTzZazDvvLDg1ut/images/slack-install-success.png?fit=max&auto=format&n=rWTzZazDvvLDg1ut&q=85&s=17c849324333c6e0e2494cafbab7928b" alt="Slack connected confirmation for the Flag Club workspace and flag-club Confidence account." width="550" className="mx-auto" data-path="images/slack-install-success.png" />
    </Frame>
  </Tab>

  <Tab title="Limited permissions">
    **Slack connected with limited permissions** means the connection succeeded, but Slack didn't grant every requested permission.
    The page lists available features and those that need additional permissions.

    Ask your Slack administrator to review the missing permissions, then select **Reconnect Slack** after approval.

    <Frame caption="A connection with channel questions available and other features requiring additional permissions.">
      <img src="https://mintcdn.com/confidence-7c0fec1b/rWTzZazDvvLDg1ut/images/slack-install-limited-permissions.png?fit=max&auto=format&n=rWTzZazDvvLDg1ut&q=85&s=58dec46018a567565a9c3f0d591062aa" alt="Flag Club connected with limited permissions, with available features and missing permissions listed." width="640" className="mx-auto" data-path="images/slack-install-limited-permissions.png" />
    </Frame>
  </Tab>

  <Tab title="Required permissions missing">
    **Slack needs additional permissions** means required permissions are missing. Confidence hasn't updated the connection.
    Expand **Missing permissions** to see what Slack needs to grant.

    Ask your Slack administrator to approve the permissions, then select **Reconnect Slack**.

    <Frame caption="The connection cannot complete without the required Slack permissions.">
      <img src="https://mintcdn.com/confidence-7c0fec1b/rWTzZazDvvLDg1ut/images/slack-install-required-permissions.png?fit=max&auto=format&n=rWTzZazDvvLDg1ut&q=85&s=07d8869eda35a7e1ca5dc8cf85fefb32" alt="Slack needs additional permissions, showing missing Send messages and Start direct messages permissions and a Reconnect Slack action." width="640" className="mx-auto" data-path="images/slack-install-required-permissions.png" />
    </Frame>
  </Tab>
</Tabs>

Feature availability also depends on your Confidence account settings, permissions, and the Slack channels the app can access.
For other connection failures, see [Troubleshoot Slack](/docs/troubleshooting/slack).

## Manage the Connection

Return to **Admin > Integrations > Slack** to manage the Slack connection for the current Confidence workspace.

| Action | What it does |
| - | - |
| **Connect Slack** | Connects a Slack workspace after you approve the requested permissions. |
| **Reconnect Slack** | Refreshes an existing connection or grants additional permissions after approval. |
| **Disable Slack** | Disconnects Slack for the current Confidence workspace, stopping its notifications and agent access. |

Disabling Slack doesn't uninstall the Confidence app from Slack.
To connect a different Slack workspace, select **Disable Slack**, then **Connect Slack**.

## Next Steps

<CardGroup cols={2}>
  <Card title="Add Confidence to a Slack Channel" href="/docs/platform/notifications/add-confidence-to-slack-channel">
    Give the app access to a channel.
  </Card>

  <Card title="Use Confidence in Slack" href="/docs/guides/use-confidence-in-slack">
    Ask questions and work with Confidence resources.
  </Card>

  <Card title="Personal Slack Notifications" href="/docs/platform/notifications/connect-personal-slack">
    Receive direct notifications about your work.
  </Card>

  <Card title="Configure Surface Notifications" href="/docs/capabilities/surfaces/configure-surface-notifications">
    Send surface activity to a channel.
  </Card>
</CardGroup>
