1. Documentation
  2. Premium roles
  3. Understanding

Selling roles to your members

The principle, in one page.


Premium roles let you automatically grant and remove Discord roles based on outside events: a purchase, a subscription, a sign-up on your site.

Bao does not need to understand your business. The contract comes down to one sentence:

An authenticated source says: "member U (or email address E) should have tier T on this server", or the opposite.

Tiers

A tier links a key (say gold) to a Discord role, with a readable label. Your external sources always target the key, never the role directly: you can change the role without breaking anything on your side.

Three ways to feed Bao

SourceFor whom
Direct webhookYou have a site, a backend, or a tool like Make or Zapier
Native StripeYou already sell with Stripe, with nothing to build
Claiming in DiscordYour buyers collect their role themselves, with their email

All three can coexist.

How Bao manages roles

Bao never drives a role "by hand": it reconciles a member's state with their entitlements. Three useful consequences:

  • Two subscriptions granting the same role are not a problem: the role is only removed when the last entitlement lapses.
  • A member who leaves and comes back gets their role back automatically.
  • Bao never touches a role that is not managed by this feature.

Discord prerequisites

Bao needs Manage Roles, and its role must sit above the premium role. Otherwise the grant fails silently from your shop's point of view: it only shows up in the premium audit log.

Premium roles are included from Bao Royal onwards.