Skip to main content

Role Mapping Basics

Mapped rolesA PayBru tier grants the Discord role you choose for that server.

Map each membership tier to a Discord role so PayBru can keep channel access aligned with who has paid, renewed, upgraded, downgraded, or ended access.

Mapped role activeMissing roleHierarchy blocked

What Role Mapping Means​

Role mapping links three things:

PayBruMembership tier

The tier the member joins, such as Follower, Supporter, or VIP.

DiscordMapped role

The server role PayBru assigns when a member has active access to that tier.

If you connect more than one Discord server to a community, choose the appropriate mapped role for each server. A tier can have one mapped role per connected server.

Role Mapping Examples​

Free tierFree Follower -> Follower

Good for public channels, announcements, and community-wide onboarding.

Paid tierSupporter -> Supporter

Good for supporter chat, bonus posts, behind-the-scenes rooms, or priority community areas.

Premium tierVIP -> VIP

Good for closed channels, voice rooms, events, or higher-touch creator access.

PayBru tierDiscord serverMapped Discord roleTypical access
Free FollowerMain community serverFollowerPublic channels, announcements
SupporterMain community serverSupporterSupporter-only chat and behind-the-scenes posts
VIPMain community serverVIPSupporter perks plus closed channels, voice rooms, or events

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

Before You Map Roles​

  1. Create the roles in Discord under Server Settings > Roles.
  2. Connect the Discord server to PayBru in Settings > Integrations. See Connecting Discord.
  3. Move the PayBru bot role above every mapped role it will manage.
  4. Create your PayBru tiers in Tiers in the Manage Portal.
Hierarchy check before mapping

Discord lets the PayBru bot manage only roles below the bot's highest role. Create your member roles below the PayBru bot role before testing access.

Map a Tier​

  1. Open the community in the Manage Portal.
  2. Go to Tiers.
  3. Create a new tier or edit an existing one.
  4. Open the Discord step in the tier wizard.
  5. Enable role assignment for the connected server.
  6. Select the Discord role that should be assigned for that tier.
  7. Leave Auto-remove role enabled if the role should be removed when the member loses that tier.
  8. Save the tier.

Repeat for each tier that should grant Discord access.

PayBru community tiers page with tier management and Discord roles column
The Tiers page shows which Discord roles are mapped to membership tiers

What Happens Automatically​

PayBru updates Discord roles when:

  • A member joins a paid or free tier.
  • A member changes tier by upgrading or downgrading.
  • A renewal succeeds.
  • A renewal fails and the grace period lapses. The role is removed when the membership moves to Ended.
  • A member cancels and the paid period finishes.

The member must:

  • Have linked Discord to their PayBru profile, and
  • Be present in the connected Discord server.

If either is missing, PayBru keeps the expected role state and applies it once the member links Discord or joins the server.

Good Setup Tips​

  • Use one mapped role per tier per server unless two tiers truly need identical Discord access.
  • Match role names to tier names so members and moderators can understand access at a glance.
  • Order roles top-down by trust and access in Discord.
  • Keep the PayBru bot role above every mapped role. This is the most common cause of missing roles.
  • Reserve Owner/Admin/Mod roles for humans and keep them above the PayBru bot role so PayBru never manages them.

Map only the member-access roles

Adminnot mapped
PayBru botautomation boundary
VIPmapped to VIP tier
Supportermapped to Supporter tier
Followermapped to Free Follower tier

Common Mistakes​

  • Pointing a tier at @everyone. Use a dedicated Follower role instead.
  • Mapping the same Discord role to a paid tier and a free tier when those members should see different channels.
  • Creating a new Discord role but forgetting to refresh roles in PayBru before selecting it.
  • Moving the PayBru bot below a mapped role during a Discord cleanup.
  • Deleting or renaming a Discord role and not re-checking the tier mapping.

Test the Mapping​

  1. Create a free or low-cost test tier if you do not already have one.
  2. Map it to a test Discord role near the bottom of the role list.
  3. Join from a separate Discord and PayBru account, or ask a trusted moderator to test.
  4. Confirm the role appears in Discord within a minute or two.
  5. Cancel or end the test membership and confirm the role disappears after access ends.

If anything goes wrong, see Common Discord Sync Issues.

See Also​