Configure group and rank binds

What this doesCopy link to What this does

Rank configuration connects Clan Labs progression and Roblox roles to Discord roles. Group binds add or remove Discord roles based on membership or rank in another Roblox community.

PrerequisitesCopy link to Prerequisites

• The connected Roblox community is active in Clan Labs.
• Clan Labs has Manage Roles and its highest role is above every managed role.
• Roblox Open Cloud is configured for workflows that change Roblox ranks.
• You meet the Settings permission requirement.
• Group binds require a plan that includes the feature.

Setup stepsCopy link to Setup steps

1. Open Manage → Ranks.
2. Create or edit each Clan Labs rank and select the matching Roblox role.
3. Add the intended Discord role, prefix, and progression values shown by the form.
4. Save and repeat from lowest to highest operational rank.
5. Open Manage → Group Binds.
6. Add the external Roblox Community ID.
7. Choose the membership or minimum-rank condition and the Discord role to apply.
8. Save the bind.
9. Run /update for a test member who should match, then for one who should not.

Expected resultCopy link to Expected result

An update gives members the roles matched by their connected-community rank and external group binds, removes managed roles they no longer qualify for, and reports the roles added or removed.

Verify that it worksCopy link to Verify that it works

Review the /update result’s Roles Added, Roles Removed, and Failed Roles fields. Confirm the Discord member’s final roles match the Roblox memberships and configured binds.

If automatic nicknames are enabled, confirm rank variables also render as expected.

Common errorsCopy link to Common errors

• A configured role is missing from the selector — it is deleted, unavailable, or above the bot.
• Unable to fetch group binds — Roblox membership information could not be loaded; retry later.
• A role appears in Failed Roles — check Manage Roles and hierarchy.
• A rank operation says Error - Rank check unavailable — Clan Labs could not verify current Roblox roles, so it changed nothing.
• The member receives conflicting roles — review overlapping rank and external group-bind rules.

Security practicesCopy link to Security practices

• Never bind a role with Administrator unless that exact escalation is intended and independently reviewed.
• Prefer one clear source of truth for each managed Discord role.
• Test changes on non-owner accounts.
• Re-test after renaming, deleting, or reordering Discord or Roblox roles.

Next, define community permissions or configure experience.