Role Mapping Basics

Role mapping tells PayBru which Discord role belongs to each membership tier.

Simple Example

PayBru tier	Discord role	Typical access
Free Follower	Follower	Public channels
Supporter	Supporter	Supporter-only channels
VIP	VIP	Higher-value channels and perks

You choose the role names. PayBru links your tiers to roles that already exist in your Discord server.

Before You Map Roles

1. Create the roles in Discord.
2. Connect the Discord server in Settings > Integrations.
3. Move the PayBru bot role above the roles it needs to assign.
4. Create your PayBru tiers in Tiers.

Map a Tier

1. Open the community in the Manage Portal.
2. Go to Tiers.
3. Create a tier or edit an existing tier.
4. Open the Discord step in the tier wizard.
5. Select the Discord role that should be assigned for that tier.
6. Review and save the tier.

Repeat this for each tier that should grant Discord access.

The Tiers page shows which Discord role is mapped to each membership tier

What Happens Automatically

PayBru updates roles when:

• A member joins a paid tier.
• A member changes tier.
• A membership renews successfully.
• A membership is cancelled, ended, or loses access.

The member must already be in the connected Discord server.

Good Setup Tips

• Keep role names simple and member-friendly.
• Avoid mapping multiple tiers to the same role unless they truly need identical access.
• Put higher-value roles above lower-value roles in Discord.
• Make sure the PayBru bot role stays above every role it manages.

Test It

1. Create a low-cost or free test tier if needed.
2. Map it to a test Discord role.
3. Join from a separate member account.
4. Confirm the role appears in Discord.
5. Cancel or end the test membership and confirm the role is removed.

If roles are not being assigned, see Common Discord Sync Issues.