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

# Account Linking

> Connect your Slack user to your Cobi account

Account linking connects your Slack user to your Cobi user. This improves attribution and makes it clear who asked each question.

## How linking works

<Steps>
  <Step title="Confirm Slack is installed">
    A Cobi admin must connect the Slack workspace from **Settings** > **Integrations** first.
  </Step>

  <Step title="Run the link command">
    In Slack, run `/cobi link`.
  </Step>

  <Step title="Open the link">
    Click **Link account** in the private Slack response.
  </Step>

  <Step title="Confirm in Cobi">
    Finish linking while signed in to the Cobi account that belongs to the connected organization.
  </Step>

  <Step title="Check status">
    Run `/cobi status` to confirm your account is linked.
  </Step>
</Steps>

## Linked users

Linked users are attributed to their Cobi user. This is useful for audit trails, answer ownership, and support.

## Unlinked users

Unlinked users can still ask Cobi questions in a connected Slack workspace. Their questions are attributed to their Slack user instead of a Cobi user.

## External guests

External guests cannot use Cobi in Slack. If an external guest mentions Cobi, Cobi rejects the request.

## Common linking issues

| Issue                        | What to do                                                      |
| ---------------------------- | --------------------------------------------------------------- |
| `Slack is not connected`     | Ask a Cobi admin to install Slack from Cobi settings            |
| Link expired                 | Run `/cobi link` again                                          |
| Link already used            | Run `/cobi link` again to create a new link                     |
| Wrong Cobi organization      | Switch to a Cobi user in the connected organization, then retry |
| `/cobi status` says unlinked | Complete `/cobi link` in Cobi                                   |

<Tip>
  You only need to link once per connected Slack workspace.
</Tip>