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

# Welcome new members

Clanzy posts a welcome card for every new member in the channel you pick, with a Get started button to choose games and get roles. Set it up: /setup welcome.

Clanzy posts a welcome card in your chosen channel whenever someone joins the server, mentions them, and adds a **Get started** button so they can pick their games and get roles right away.

## Before you start

- Clanzy is in your server ([add the bot](https://clanzy.app/en/docs/getting-started/invite)).
- You own the server or have the **Manage Server** permission. Without it, `/setup` does not show up in the `/` menu.
- In the welcome channel, Clanzy needs **View Channel**, **Send Messages** and **Embed Links**. See [Clanzy's permissions](https://clanzy.app/en/docs/getting-started/permissions).

## Quick setup

### With a command

Type `/setup welcome` in your server. Clanzy will:

1. Use the welcome channel you already picked, or find a text channel named `welcome`, or create one at the top of the channel list.
2. On a channel it creates, stop @everyone from sending messages so only the bot posts there.
3. Turn welcomes on.

Then type `/setup welcome-test` to see the real card, sent for you. To set up intro questions and voice rooms at the same time, use [`/setup all`](https://clanzy.app/en/docs/getting-started/setup-all).

> [!NOTE]
> Channel names follow the bot language. A server on Vietnamese gets `chào-mừng` instead of `welcome`.

### With the dashboard

[Open the Welcome section](https://app.clanzy.app/?open=welcome), pick a **Welcome channel**, turn on **Send a welcome message** and press **Save changes**. This is also where you write your own message, preview the card and press **Send a test welcome**.

## How it works

- Someone joins → Clanzy posts the card in the welcome channel: a mention (so they get a notification), the title **A new member joined**, their avatar, and a footer with the server name and member count.
- Each member is welcomed **once, ever**. Leaving and rejoining does not post a new card.
- If your server uses Discord's membership screening, Clanzy waits until the member accepts the rules.
- Bots are never welcomed. The card uses the bot language (see [language](https://clanzy.app/en/docs/language)).
- **Get started** opens the [intro questions](https://clanzy.app/en/docs/onboarding). The button only shows while onboarding is on.

The default message:

> Welcome {user} to **{server}**! You are member **#{memberCount}**.
> Press **Get started** to pick the games you play and get your roles.

### Placeholders

| Placeholder | Shows |
| --- | --- |
| `{user}` | A mention of the member (@name) |
| `{username}` | The member's name, without a mention |
| `{server}` | The server name |
| `{memberCount}` | The current member count |

Messages support **bold** and line breaks, up to 1500 characters. A misspelled placeholder is flagged by the dashboard when you save.

## Settings

| Setting | Default | Options | Where to change it |
| --- | --- | --- | --- |
| Send a welcome message | On (but nothing posts until a channel is set) | On / Off | [Dashboard](https://app.clanzy.app/?open=welcome), `/setup welcome` |
| Welcome channel | Not set | Any text channel | [Dashboard](https://app.clanzy.app/?open=welcome), `/setup welcome` |
| Welcome message | Default message in the bot language | Your own text, up to 1500 characters | [Dashboard](https://app.clanzy.app/?open=welcome) |
| Get started button | Shown | Shown / Hidden | [Dashboard](https://app.clanzy.app/?open=welcome) |

## Commands

| Command | What it does | Who can use it |
| --- | --- | --- |
| [`/setup welcome`](https://clanzy.app/en/docs/commands/setup-welcome) | Finds or creates the welcome channel and turns welcomes on | Manage Server |
| [`/setup welcome-test`](https://clanzy.app/en/docs/commands/setup-welcome-test) | Posts a test welcome card for you | Manage Server |
| [`/config view`](https://clanzy.app/en/docs/commands/config-view) | Shows the current settings | Manage Server |

A test card says **🧪 Test message from an admin** in its footer and does not count as your real welcome. Each server can send one test every 10 seconds (shared with the dashboard button).

> [!NOTE]
> Welcomes are free, for servers of any size. See [limits](https://clanzy.app/en/docs/limits) and [pricing](https://clanzy.app/en/pricing).

## Troubleshooting

- **New members get no card**: check that a channel is set and welcomes are on, then check the bot's permissions in that channel. See [Welcome not sent](https://clanzy.app/en/docs/troubleshooting/welcome-not-sent).
- **`/setup welcome-test` says "There is no welcome channel yet"**: run `/setup welcome` or pick a channel in the dashboard first.
- **The test says "Welcomes are turned off"**: the test still posts, but new members do not get the card. Turn on **Send a welcome message** in the dashboard.
- **No Get started button on the card**: onboarding is off, or the button is hidden. See [intro questions](https://clanzy.app/en/docs/onboarding).
- **`/setup` is missing**: you need **Manage Server**. See [Slash commands not showing](https://clanzy.app/en/docs/troubleshooting/slash-commands-not-showing).

## Related

- [Intro questions and game roles](https://clanzy.app/en/docs/onboarding)
- [Set everything up with /setup all](https://clanzy.app/en/docs/getting-started/setup-all)
- [Discord welcome bot guide](https://clanzy.app/en/guides/discord-welcome-bot)

Updated: 2026-11-19
