- Documentation
- Premium roles
- 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
| Source | For whom |
|---|---|
| Direct webhook | You have a site, a backend, or a tool like Make or Zapier |
| Native Stripe | You already sell with Stripe, with nothing to build |
| Claiming in Discord | Your 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.