Skip to content
Clan LabsDocs
API referenceWebsite Open dashboard
Get startedDashboardDiscord botRoblox & Open CloudTroubleshooting
Documentation
Overview
  • Introduction
  • What is Clan Labs?
  • Core concepts
  • Requirements
  • Plans and availability
  • Quick start
Getting Started
  • Create or sign in
  • Add the Discord bot
  • Start setup with /setup
  • Select a Discord server
  • Connect a Roblox community
  • Confirm ownership
  • Choose a subscription
  • Configure Open Cloud
  • Complete setup
  • Recommended next steps
Setup Guides
  • Discord bot permissions
  • Roblox community connection
  • Roblox Open Cloud
  • Verification
  • Group and rank binds
  • Community permissions
  • Experience
  • Quotas
  • Welcome messages
  • Audit-log delivery
  • Events
  • Subscriptions
  • API keys
  • Divisions
Feature Guides
  • Member management
  • Profiles
  • Linked Roblox accounts
  • Experience and quotas
  • Ranks and group binds
  • Warnings
  • Suspensions
  • Blacklists
  • Medals and qualifications
  • Events and attendance
  • Audit logs and rollback
  • Analytics
  • Community permissions
  • Discord commands and actions
  • Pending join reviews
  • Custom bot branding
  • Discord server transfers
  • Privacy and account controls
  • Subscriptions and billing
Troubleshooting
  • Troubleshooting overview
  • Discord server is missing
  • Roblox community not found
  • Ownership cannot be confirmed
  • Bot permissions are missing
  • Discord role does not update
  • Role is above the bot
  • Verification fails
  • Open Cloud errors
  • Rank change fails
  • Profile does not sync
  • Command is unavailable
  • Action is not permitted
  • Subscription access is missing
  • Temporary service problem
API referenceClan Labs websiteOpen dashboard Support
Overview
  • Introduction
  • What is Clan Labs?
  • Core concepts
  • Requirements
  • Plans and availability
  • Quick start
Getting Started
  • Create or sign in
  • Add the Discord bot
  • Start setup with /setup
  • Select a Discord server
  • Connect a Roblox community
  • Confirm ownership
  • Choose a subscription
  • Configure Open Cloud
  • Complete setup
  • Recommended next steps
Setup Guides
  • Discord bot permissions
  • Roblox community connection
  • Roblox Open Cloud
  • Verification
  • Group and rank binds
  • Community permissions
  • Experience
  • Quotas
  • Welcome messages
  • Audit-log delivery
  • Events
  • Subscriptions
  • API keys
  • Divisions
Feature Guides
  • Member management
  • Profiles
  • Linked Roblox accounts
  • Experience and quotas
  • Ranks and group binds
  • Warnings
  • Suspensions
  • Blacklists
  • Medals and qualifications
  • Events and attendance
  • Audit logs and rollback
  • Analytics
  • Community permissions
  • Discord commands and actions
  • Pending join reviews
  • Custom bot branding
  • Discord server transfers
  • Privacy and account controls
  • Subscriptions and billing
Troubleshooting
  • Troubleshooting overview
  • Discord server is missing
  • Roblox community not found
  • Ownership cannot be confirmed
  • Bot permissions are missing
  • Discord role does not update
  • Role is above the bot
  • Verification fails
  • Open Cloud errors
  • Rank change fails
  • Profile does not sync
  • Command is unavailable
  • Action is not permitted
  • Subscription access is missing
  • Temporary service problem
  1. Docs
  2. /
  3. Feature Guides
Feature Guides

Manage ranks and group binds

Change Roblox ranks safely and use Clan Labs binds to translate group membership into Discord roles and nicknames.

Last updated 3 September 2026

Rank actions change a member’s role in the connected Roblox community. Binds translate Roblox group and rank information into Discord roles or nickname behaviour.

Change a Roblox rank

Staff can use a member profile or Discord commands:

  • /promote moves a member to the next eligible configured rank.
  • /demote moves a member to the previous eligible configured rank.
  • /changerank selects a permitted destination rank.

Before the change, Clan Labs checks the target, staff requirement, rank boundaries, blacklist and suspension state, community entitlement, and current Roblox group data. The Open Cloud key must still permit group reads and writes.

The default requirement is Officer for ordinary member rank changes and HICOM when the target is treated as an officer. Owners can customise this in Community Permissions.

If Clan Labs shows Error - Rank check unavailable, no rank change was made. Wait for the dependent service to recover, then check the current Roblox rank before retrying.

ProAPI Rank Management

Changing ranks through API v2 requires the members.ranks.write scope and Clan Labs Pro. Dashboard and Discord rank controls follow their own configured plan and permission rules.

Compare plans

Apply role and rank binds

Rank binds map particular ranks from a connected Roblox group to Discord behaviour. Group binds can apply rules based on membership in an additional Roblox group. Premium includes group binds; availability is shown by the Clan Labs plan comparison.

After changing bind settings:

  1. Run /update for a test member or use Apps → Update User.
  2. Read the separate Auto Roles and Nickname results.
  3. Check any listed Roles Added, Roles Removed, or Failed Roles.
  4. Confirm that unrelated roles were not affected.

Clan Labs only manages roles represented by the active configuration. Discord still enforces its hierarchy: the Clan Labs bot’s highest role must be above every role it needs to assign or remove.

Rank safety practices

  • Give the Open Cloud key only group:read and group:write for the intended group.
  • Limit destination ranks; never expose owner-level group roles through routine staff actions.
  • Keep high-trust rank actions at HICOM or Owner.
  • Audit bind changes before bulk updating members.
  • Use user IDs to distinguish similar Roblox names.
  • Check the actual Roblox rank after any timeout before retrying a write.

For configuration, see Group and rank binds. For failures, use Rank change fails or Discord role does not update.

PreviousExperience and quotasNext Warnings
On this page
  1. Change a Roblox rank
  2. Apply role and rank binds
  3. Rank safety practices