Skip to content

Role order

Why the Clanzy role must sit above your game, gender and Member roles, how to move it on desktop and phone, how to check it, and the warnings the bot shows.

Discord has one hard rule: a bot can only give and remove roles that sit below its own highest role. When you add Clanzy, Discord creates a Clanzy role and usually puts it near the bottom of the list. If a game role, gender role or the Member role sits above it, Clanzy cannot assign that role, even with Manage Roles.

When you need to move it

  • Roles that /setup creates already sit below the Clanzy role, so usually nothing to do.
  • Older roles that share a game's name (say, a Valorant role you made long ago) are reused by Clanzy and may sit above it.
  • Roles you picked by hand in the dashboard.
  • Someone dragged the Clanzy role down later.

The order to aim for, top to bottom: Admin and Mod roles, then Clanzy, then game roles, gender roles and Member. Clanzy does not need to be above your Admin role, and should not be.

On desktop

  1. Click the server name at the top left and choose Server Settings.
  2. Open Roles.
  3. Grab the Clanzy role and drag it above the game, gender and Member roles.
  4. Press Save Changes in the bar that appears at the bottom.

On a phone

  1. Open the server, tap its name at the top and choose Settings.
  2. Open Roles.
  3. Press and hold the Clanzy role, drag it above the roles it should give, then save.

If your app version will not let you drag, do it on a computer or in Discord in a browser.

How to check

  • Run /setup onboarding again. No ⚠️ line about roles means you are done.
  • In the dashboard, the Onboarding section no longer shows Clanzy can't assign ... role(s) yet, and role pickers no longer say Clanzy can't assign this role yet. Refresh the role list after moving roles.
  • Type /setup welcome-test, press Get started on the card, pick games and check the roles arrive. Use /roles to try again.

The warnings Clanzy shows

When /setup all or /setup onboarding finds roles above Clanzy's role, the summary includes:

Tip: drag the Clanzy role above these roles in Server Settings → Roles so the bot can assign them: ...

When a member answers the intro questions and a role cannot be given, they see:

Could not assign: ... Clanzy's role must sit above these roles (Server Settings → Roles).

Clanzy still gives every other role and only skips the stuck ones. Once you fix the order, the member types /roles and submits again to get everything.

Still stuck? See Bot role too low and Members not getting roles.

Updated