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

# Troubleshooting

> Common setup issues and how to fix them.

If the Suby bot is not working as expected, check the following common issues.

## Common Issues

<AccordionGroup>
  <Accordion title="Roles are not being assigned or revoked">
    The Suby bot role must be positioned **above** all paid roles in your Discord role hierarchy. If it is lower, Discord will prevent the bot from assigning or removing those roles.

    Go to **Server Settings → Roles** and drag the Suby Bot role above all roles it needs to manage.
  </Accordion>

  <Accordion title="Bot is not sending messages or notifications">
    Make sure the Suby bot has the following permissions at the server level:

    * Send Messages
    * Send Messages in Threads
    * Embed Links
  </Accordion>

  <Accordion title="Bot cannot access a specific channel">
    For each channel linked to Suby, make sure the bot has the following channel-level permissions:

    * View Channel
    * Send Messages
    * View Message History
    * Embed Links

    <Card title="How to Give Discord Permissions" icon="lock-open" href="/v2/guides/discord/permissions">
      Step-by-step guide to configuring bot permissions at server and channel level.
    </Card>
  </Accordion>

  <Accordion title="Slash commands are not working">
    Only server Admins can run Suby bot commands. Make sure you have the Admin role on the server before running any slash command.
  </Accordion>

  <Accordion title="Roles are not linked to a product">
    If the bot is active but not assigning roles after payment, the role may not be linked to your product. Run `/setuprole` in your server to link a role to a paid product.
  </Accordion>
</AccordionGroup>

<Note>
  If you are still experiencing issues after checking the above, reach out via [Suby support](https://www.suby.fi/support).
</Note>