Discord Bot
Our bot handles role management, slash commands, DM automations, and audit logging in your Discord server.
Setup
Invite the Bot
Grant Permissions
Manage Roles permission.Configure Role Hierarchy
Role Hierarchy is Important
Member Commands
| Command | Description |
|---|---|
/subscribe | Displays available packages with pricing. Shows a dropdown selector when there are 5+ packages, or inline buttons for fewer. |
/status | Shows your current subscription status with a rich embed including package name, price, interval, renewal date, and role assignments. |
/cancel | Initiates the cancellation flow. Shows a confirmation prompt with "Confirm Cancel" and "Keep Subscription" buttons. |
/billing | Shows your active subscription summary and provides a link to update payment method via Stripe Customer Portal. |
/help | Lists all available commands with descriptions. |
Admin Commands
Admin commands require the Administrator permission or the server owner role.
| Command | Description |
|---|---|
/stats | Quick revenue and subscriber summary displayed in a rich embed. Pulls analytics from the dashboard backend. |
/grant @user [package] | Manually grant a subscription and assigned role(s) to a user. Sends a DM notification to the user. |
/revoke @user | Revoke a user's subscription and remove assigned roles. Accepts an optional reason. |
/lookup @user | Detailed lookup showing the user's subscription history, payment info, roles, and account age. |
/sync | Force-sync all member roles with subscription data. Reports how many roles were added, removed, or unchanged. |
/announce [message] | Send an announcement to all subscribers via DM. Shows a preview embed before sending with confirm/cancel buttons. |
/dashboard | Provides a direct link to the web dashboard. |
Automated Actions
The bot performs these actions automatically based on subscription lifecycle events:
Role Management
- Role assignment — instantly assigns configured Discord roles when a subscription is activated
- Role removal — automatically removes roles when a subscription ends, is cancelled (at period end), or payment fails after the grace period
- Role restoration — when a member leaves and rejoins the server, the bot checks for active subscriptions and restores roles automatically
DM Automations
Configure automated DMs in Settings → Bot. Each type can be individually enabled/disabled with custom messages:
- Welcome DM — sent when a new subscriber purchases. Includes package details and a thank-you message.
- Renewal Reminder — sent 3 days before renewal date with subscription details and a link to manage billing.
- Payment Failed — sent when a payment attempt fails. Includes a link to update payment method.
- Cancellation Confirmation — confirms cancellation with end-of-period date.
- Trial Ending — notifies 3 days before a free trial expires.
- Re-engagement — optional message sent to churned members after a configurable delay.
Audit Channel
Designate a channel for the bot to post all subscription events. Configure in Settings → Server by selecting an audit channel. Events include:
- New subscriptions
- Renewals and payments
- Cancellations and expirations
- Payment failures
- Role changes
- Admin actions (grant/revoke)
Required Bot Permissions
| Permission | Reason |
|---|---|
| Manage Roles | Assign/revoke subscriber roles |
| Send Messages | Post in audit channel |
| Embed Links | Rich embed messages |
| View Channels | See channel list |
| Read Message History | Context for interactions |
Troubleshooting
Bot can't assign roles
Ensure the bot's role is positioned above the target role in your server's role hierarchy (Server Settings → Roles → drag the bot role higher).
Commands not showing
Slash commands may take up to 1 hour to propagate globally. Try restarting Discord or checking that the bot has the applications.commands scope.