> For the complete documentation index, see [llms.txt](https://suby.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://suby.gitbook.io/documentation/platform-integration/discord.md).

# Discord

#### Overview

The Suby bot acts as an access controller for your Discord community. Its core role is to grant, manage, and revoke access to private channels based on a user’s payment status.

Access on Discord is handled through roles, which are automatically assigned or removed depending on payments and renewals.

***

#### How Discord Gating Works

Discord access is granted through a role linked to a paid product.

* The role unlocks private channels
* Losing the role immediately removes access

Suby bot automates this entire flow.

***

#### Granting Access

Suby bot can:

* Invite a user into your Discord server even if they are not already a member
* Assign the correct paid role immediately after a successful payment
* Assign a role to users who are already inside the Discord

If the payment is successful, the role is applied automatically.

***

#### Removing Access

Suby bot automatically removes access in the following cases:

* Payment fails → no role is assigned
* Card subscription fails to renew → role is removed
* Crypto subscription is not renewed after the reminder period → role is removed

Access is always synced with the subscription state.

***

#### Notifications & Reminders

Suby bot sends notifications to keep both admins and members informed:

* Payment successful
* Renewal reminder (crypto subscriptions only)
* Access removed due to non-payment

These notifications help reduce churn and avoid confusion.

***

#### Free Access (Free Days)

You can grant temporary access to any user using the /freedays command.

* Assign a role for a fixed number of days
* Role is automatically removed when the free period ends

Useful for trials, giveaways, or manual exceptions.

***

For more details, check our guides on integration, notification setup, commands, and common errors.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://suby.gitbook.io/documentation/platform-integration/discord.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
