> Full Clanzy docs index (for AI agents): https://clanzy.app/en/llms.txt · HTML page: https://clanzy.app/en/docs/onboarding

# Intro questions and game roles

New members pick their gender and the games they play, and Clanzy gives them the matching roles. They can change answers any time with /roles.

The intro questions ask members their gender and which games they play, then Clanzy gives them the matching roles, so every game gets its own group and newcomers find teammates right away.

## Before you start

- Clanzy has **Manage Roles** (included when you [add the bot](https://clanzy.app/en/docs/getting-started/invite)).
- The **Clanzy** role must sit **above** the game, gender and member roles. This is the most common problem, see [role order](https://clanzy.app/en/docs/getting-started/role-order).
- You need **Manage Server** to configure it.

## Quick setup

### With a command

Type `/setup onboarding`. Clanzy will:

1. If the server has no games yet, add a starter list: Valorant, Liên Minh Huyền Thoại (League of Legends), Teamfight Tactics, Delta Force, Naraka: Bladepoint, PUBG.
2. Link each game to an existing role with the same name, or create a new role just below the bot's role.
3. Do the same for the **Male** and **Female** gender options, and set up a **Member** role for everyone who finishes.
4. Turn the intro questions on and list any role that still sits above the bot.

You can run it again any time: roles already linked stay as they are, nothing is duplicated. To set up the welcome channel and voice rooms too, use [`/setup all`](https://clanzy.app/en/docs/getting-started/setup-all).

> [!NOTE]
> Role names follow the bot language. A server on Vietnamese gets **Nam**, **Nữ** and **Thành viên**.

### With the dashboard

[Open the Onboarding section](https://app.clanzy.app/?open=onboarding) to add games (type a name or use **Quick add**), set an emoji and role for each, reorder them, customise the gender options and pick a **Member role**. Games without a role can wait: run `/setup onboarding` and Clanzy creates their roles.

## How it works

Members open the questions with the **Get started** button on the [welcome card](https://clanzy.app/en/docs/welcome) or by typing `/roles`. A **Quick intro** form appears with:

- **Gender**: one of **Male**, **Female**, **Other**, **Prefer not to say** (required while the question is on).
- **Which games do you play?**: as many as they like, or none.

On submit, Clanzy:

- Adds the roles of the games they picked and removes the roles of games they unpicked.
- Gives the role of their gender option and removes the other gender roles. **Other** and **Prefer not to say** have no role by default.
- Adds the member role (it is never removed).
- Skips any role above the bot and says so in the reply.

The **All set!** reply is only visible to them. It lists the roles added and removed and ends with "Type `/roles` any time to change your answers." Their previous answers are preselected next time. Clanzy only touches the roles it manages; a member's other roles are left alone.

## Settings

| Setting | Default | Options | Where to change it |
| --- | --- | --- | --- |
| Intro questions | On | On / Off | [Dashboard](https://app.clanzy.app/?open=onboarding) |
| Ask for gender | On | On / Off | [Dashboard](https://app.clanzy.app/?open=onboarding) |
| Gender options | Male, Female, Other, Prefer not to say | 2 to 10 options, each with a role or none | [Dashboard](https://app.clanzy.app/?open=onboarding) |
| Games and roles | Empty (`/setup onboarding` adds 6) | Up to 25 games, each with a name, emoji and role | [Dashboard](https://app.clanzy.app/?open=onboarding), `/setup onboarding` |
| Member role | None (`/setup onboarding` creates **Member**) | Any role | [Dashboard](https://app.clanzy.app/?open=onboarding), `/setup onboarding` |

When the gender question is off, members keep their gender roles; Clanzy does not remove them.

## Commands

| Command | What it does | Who can use it |
| --- | --- | --- |
| [`/roles`](https://clanzy.app/en/docs/commands/roles) | Opens the intro questions again to change roles | Everyone |
| [`/setup onboarding`](https://clanzy.app/en/docs/commands/setup-onboarding) | Adds starter games and creates missing roles | Manage Server |
| [`/setup welcome-test`](https://clanzy.app/en/docs/commands/setup-welcome-test) | Posts a test welcome so you can press **Get started** like a newcomer | Manage Server |

> [!NOTE]
> Free has up to 25 games, because a Discord select menu holds at most 25 options. Pro splits them into two menus for 50 games and 25 gender options. See [limits](https://clanzy.app/en/docs/limits).

## Troubleshooting

- **"Could not assign: … Clanzy's role must sit above these roles"**: drag the **Clanzy** role higher in **Server Settings → Roles**. See [Role too low](https://clanzy.app/en/docs/troubleshooting/role-too-low).
- **Answered but got no role**: the game has no role yet, or the bot lacks **Manage Roles**. See [Roles not given](https://clanzy.app/en/docs/troubleshooting/onboarding-roles-not-given).
- **"This server has not turned on the intro questions."**: turn on **Intro questions** in the dashboard.
- **"This server has no games or questions yet."**: the gender question is off and there are no games. Run `/setup onboarding` or add games in the dashboard.
- **The bot says a permission is missing**: see [Missing permissions](https://clanzy.app/en/docs/troubleshooting/missing-permissions).

## Related

- [Welcome new members](https://clanzy.app/en/docs/welcome)
- [Monthly game role cleanup](https://clanzy.app/en/docs/game-roles) (Pro): remove game roles from people who stopped playing
- [Role order and why it matters](https://clanzy.app/en/docs/getting-started/role-order)
- [Discord auto role bot guide](https://clanzy.app/en/guides/discord-auto-role-bot)

Updated: 2026-11-19
