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

# Launch a Discord supporter tier

> From bot setup to first paying member, end to end.

You have a Discord server. You want to sell access to a private channel, a supporter role,
or ongoing perks for a monthly fee. This walkthrough takes you from zero to a working
supporter tier in about 20 minutes.

## What you'll have at the end

* A Discord role that gets granted automatically when someone subscribes on your shop.
* The role is revoked when the subscription is canceled or fails (as long as "Remove role on
  cancel" stays on — it's the default).
* A customer dashboard your buyers use to manage their subscription themselves.

## Prerequisites

* A Discord server you own (you need `Manage Server` permission).
* A Shoppex shop with at least one payment gateway connected. If you don't, do
  [Quickstart](/merchants/start/quickstart) first.

## Step 1 — Connect Discord and invite the bot

In your Shoppex dashboard, open **Settings → Integrations → Discord**.

1. Click **Connect Discord**. This is the OAuth step that links your Discord identity to your
   Shoppex account.
2. Pick the target server from the dropdown that appears.
3. Click **Invite Bot**. Discord opens its OAuth approval flow asking you to authorize the
   Shoppex bot on the server you just picked.
4. The bot requests **Manage Roles**, **View Channels**, **Send Messages**, and **Embed
   Links**. Accept.
5. Discord redirects you back to Shoppex with the bot connected.

In your Discord server settings, you'll now see the Shoppex bot listed as a member.
**Important:** its role in the server hierarchy must sit *above* any role you intend to sell.
This is a Discord rule — bots can only manage roles below their own. Drag the Shoppex role up
in **Server Settings → Roles** if needed.

## Step 2 — Create the supporter role

In Discord → **Server Settings → Roles → Create Role**. Give it a name like `Supporter`,
pick a color, set any permissions for private channels you want this role to see.

This role is now ready to be tied to a Shoppex product.

## Step 3 — Create the subscription product

Back in Shoppex → **Products → New product**.

* **Type:** Subscription (this is the product Type — not the Discord-role concept; that
  comes next).
* **Title:** "Supporter — Monthly" (or whatever fits).
* **Price:** Set monthly amount and billing interval.

Then scroll to the product's **Discord** section and:

* Toggle **Assign Role** on.
* Pick the server.
* Pick the `Supporter` role (loaded live from your server).
* Leave **Remove role on cancel** on (the default) so the role gets revoked when the
  subscription ends.

Save the product. It's now live on `yourshop.shoppex.io`.

## Step 4 — Test the flow yourself

Open your shop in an incognito window. Buy the product with one of your own gateways (or use
a Stripe test key if you connected one). You should see:

1. Checkout asks you to link your Discord account.
2. You authorize via Discord OAuth.
3. You pay.
4. Within a few seconds, the Supporter role appears on your Discord account.

If anything stalls: the order page in your dashboard tells you exactly which step is pending.

## Step 5 — Announce it

Share the product link in your server (or anywhere). Buyers click → checkout → done.

## What happens when someone subscribes

Each month:

* The subscription auto-renews against the gateway the buyer used at signup.
* If renewal succeeds, the role stays. No action needed from you or them.
* If renewal fails, Shoppex enters a 7-day grace period (configurable in shop settings). The
  role stays. The buyer is asked to update payment.
* Once the subscription has two voided invoices total (cumulative across its lifetime, not
  just consecutive), Shoppex auto-cancels it. The role is revoked at cancel time.

Buyers can cancel anytime from their customer dashboard. Cancellation behavior depends on
gateway — see [Subscriptions](/merchants/products/subscriptions#cancellation) for the
specifics (Stripe/crypto cancel at period end, PayPal cancels immediately).

## Common questions

**"Can I have multiple supporter tiers?"** Yes. Create a separate product per tier
(Bronze / Silver / Gold), bound to different roles. A buyer can hold several at once.

**"Can I grant roles across multiple servers?"** Not from one product — Assign Role binds to
one role on one server. To cover multiple servers, create multiple products and either
bundle them or use addons.

**"What if a buyer leaves my Discord server?"** Shoppex can't grant a role to someone who
isn't in the server. The order pauses in pending-fulfillment until they rejoin, then you
can re-trigger fulfillment from the order page.

**"What if I delete the role?"** Shoppex can't grant a role that no longer exists. Existing
holders lose it implicitly (because the role is gone), and new orders fail to fulfill. Don't
delete roles tied to active subscriptions.

<Card title="Next: Subscriptions reference" href="/merchants/products/subscriptions">
  Trials, plan changes, retries, and pauses for any subscription product.
</Card>