> Full Clanzy docs index (for AI agents): https://clanzy.app/en/llms.txt · HTML page: https://clanzy.app/en/docs/getting-started/role-order

# 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](https://app.clanzy.app/?open=onboarding).
- 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.

> [!NOTE]
> You can only move roles that sit below your own highest role. The server owner can move any role. If you cannot move the Clanzy role, ask the owner.

## How to check

- Run [`/setup onboarding`](https://clanzy.app/en/docs/commands/setup-onboarding) again. No ⚠️ line about roles means you are done.
- In the [dashboard](https://app.clanzy.app/?open=onboarding), 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`](https://clanzy.app/en/docs/commands/setup-welcome-test), press **Get started** on the card, pick games and check the roles arrive. Use [`/roles`](https://clanzy.app/en/docs/commands/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](https://clanzy.app/en/docs/troubleshooting/role-too-low) and [Members not getting roles](https://clanzy.app/en/docs/troubleshooting/onboarding-roles-not-given).

Updated: 2026-11-19
