Skip to main content

Common Discord Sync Issues

Discord sync triageMost access issues are account link, server membership, mapping, or bot permission issues.

Start with the status label, then check the Discord server, PayBru tier mapping, and the member's linked Discord account.

Not linkedNot in serverPermission errorDelayed sync

Most sync issues fall into a handful of categories. Start with the matching section below.

Quick Triage​

Member accountNot linked

The member needs to connect Discord under Resources > My Profile > Security > Connected Accounts.

Creator serverNot in server

The member linked Discord but has not joined the creator's Discord server with that account.

Mapped roleMissing role

The tier points to a Discord role that was deleted, renamed, or not selected for that server.

PayBru botPermission error

The bot lacks Manage Roles, cannot see what it needs, or sits below the target role.

Bot Permission Errors​

Symptom: You see a missing permissions warning or roles are not assigned.

Fix:

  1. Open Server Settings > Roles in Discord.
  2. Click the PayBru bot role.
  3. Confirm the bot has the permissions it needs, especially Manage Roles.
  4. Confirm the bot can see the server areas it needs.
  5. Check that channel overrides do not block the bot where it needs access.
Permission repair

If you remove the bot's permissions and add them again, refresh or reconnect the integration from Settings > Integrations so PayBru can re-check the server.

Role Hierarchy Problems​

Symptom: The bot can assign some roles but not others.

Cause: Discord requires the bot's highest role to sit above every role it manages.

Broken hierarchy example

Adminhuman only
VIPmapped role above bot
PayBru bottoo low to manage VIP
Supportermanageable

Fix:

  1. Go to Server Settings > Roles.
  2. Drag the PayBru role above every mapped role it needs to manage.
  3. Click Save Changes.

Delayed Sync​

Symptom: A member subscribes but their role appears later instead of instantly.

Possible causes:

  • Discord is slowing down role changes.
  • Payment confirmation is still settling.
  • The next role check has not completed yet.
  • The member linked Discord or joined the server after subscribing.

If the delay exceeds 10 minutes, refresh Settings > Integrations and check again after the next sync.

Members Not Getting Roles​

Symptom: A member has an active subscription but no Discord role.

Checklist:

  1. The member linked Discord on their PayBru profile.
  2. The member joined your Discord server with the linked Discord account.
  3. The tier is mapped to the correct role in Tiers.
  4. The subscription is still active in Members.
  5. The PayBru bot role is above the mapped role.
Account link vs server join

A member can connect a Discord account without joining your server, and they can join your server without linking Discord to PayBru. Both must be true before PayBru can apply the role.

Roles Removed Unexpectedly​

Symptom: A member loses their role even though they believe they are still subscribed.

Possible causes:

  • A server moderator manually removed the role. PayBru will reassign it during the next role sync if the member still qualifies.
  • The member's payment failed and the 6-day grace period expired. See Failed Payments and Access Changes.
  • The tier's Discord role setting was deleted or changed.
  • The member was downgraded, canceled, or moved to a tier with a different mapped role.
  • The member unlinked Discord from PayBru or left the Discord server.

Check the member's status in Members and the connected server status in Settings > Integrations.

Health Check and Permission Monitoring​

PayBru regularly checks whether the bot still has the permissions and role hierarchy it needs.

PayBru checks for:

  • Required bot permissions, including Manage Roles and server visibility.
  • A bot role that has been moved below mapped tier roles.
  • Disconnected or stale Discord server connections.

If a problem is detected, PayBru notifies the community owner. There is a short delay before the first alert so routine Discord cleanup does not trigger unnecessary notifications.

Owner action

If you receive a health notification, review the bot permissions in Server Settings > Roles and confirm the PayBru role sits above every mapped role.

Bot Appears Offline​

Symptom: The PayBru bot shows as offline in the member list.

The bot does not need to appear online to manage roles. As long as Settings > Integrations shows the server as connected, role management can continue.

If the connection shows disconnected, reconnect the server from your integration settings.

Error Handling​

PayBru handles Discord sync errors as follows:

  • Temporary Discord issues are retried on a later sync.
  • One member's role issue does not stop other members from syncing.
  • Disconnected servers are skipped until the creator reconnects Discord from Settings > Integrations.

See Also​