> ## Documentation Index
> Fetch the complete documentation index at: https://docs.razebot.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome & Welcome DM

> Send automated channel welcome greetings and direct-message welcomes to new members.

# Welcome & Welcome DM

<Badge variant="pro">Tier 2: Pro</Badge>

> Greet new community members the moment they join your server with customizable channel welcome announcements and personalized direct-message (DM) welcomes.

***

## Commands Overview

| Command      | Category  | Tier | Syntax                                | Description                                | Permissions   |
| :----------- | :-------- | :--- | :------------------------------------ | :----------------------------------------- | :------------ |
| `.welcome`   | `welcome` | Pro  | `.welcome <subcommand> [arguments]`   | Configure channel welcome announcements.   | Administrator |
| `.welcomedm` | `welcome` | Pro  | `.welcomedm <subcommand> [arguments]` | Configure private direct message welcomes. | Administrator |

***

## Channel Welcome Setup

### welcome

| Subcommand | Syntax                                   | Description                          | Example                                                                     |
| :--------- | :--------------------------------------- | :----------------------------------- | :-------------------------------------------------------------------------- |
| `on`       | `.welcome on`                            | Enables channel welcome messages     | `.welcome on`                                                               |
| `off`      | `.welcome off`                           | Disables channel welcome messages    | `.welcome off`                                                              |
| `channel`  | `.welcome channel <#channel\|channelID>` | Sets target channel for welcomes     | `.welcome channel #welcome`                                                 |
| `message`  | `.welcome message <message content>`     | Configures custom welcome text/embed | `.welcome message Welcome {user} to {server}! We hope you enjoy your stay.` |
| `test`     | `.welcome test`                          | Sends a test welcome message         | `.welcome test`                                                             |
| `config`   | `.welcome config`                        | Views active welcome configuration   | `.welcome config`                                                           |
| `reset`    | `.welcome reset`                         | Resets channel welcome setup         | `.welcome reset`                                                            |

***

## Direct Message (DM) Welcome Setup

### welcomedm

| Subcommand | Syntax                                 | Description                            | Example                                                                         |
| :--------- | :------------------------------------- | :------------------------------------- | :------------------------------------------------------------------------------ |
| `on`       | `.welcomedm on`                        | Enables welcome DMs for new members    | `.welcomedm on`                                                                 |
| `off`      | `.welcomedm off`                       | Disables welcome DMs                   | `.welcomedm off`                                                                |
| `message`  | `.welcomedm message <message content>` | Sets custom DM text sent to member     | `.welcomedm message Welcome {username} to {server}! Be sure to read the rules.` |
| `test`     | `.welcomedm test`                      | Sends a test welcome DM to yourself    | `.welcomedm test`                                                               |
| `config`   | `.welcomedm config`                    | Views current welcome DM configuration | `.welcomedm config`                                                             |
| `reset`    | `.welcomedm reset`                     | Resets welcome DM configuration        | `.welcomedm reset`                                                              |

***

## Dynamic Variables Available

You can use any of the dynamic placeholders in your welcome messages:

* `{user}` — Mentions the joining user (`@Username`)
* `{user.name}` — Username of the joining member
* `{user.tag}` — Full tag (`username#0000`)
* `{user.id}` — User's unique ID
* `{user.createdate}` — User account creation date
* `{server}` — Server name
* `{server.membercount}` — Total member count
* `{server.membercount_ordinal}` — Member count with suffix (e.g. `100th`)
* `{server.membercount_nobots}` — Total humans count (excluding bots)
* `{inviter.name}` / `{inviter.mention}` — Name / mention of the member who invited them
* `{invites}` — Total invites count of the inviter

> \[!TIP]
> See the complete list in the [Variables Reference](/resources/variables).

<Tabs>
  <Tab title="Channel Welcome">
    ```bash theme={null} theme={null}
    .welcome channel #welcome-hall
    .welcome message Welcome {user} to **{server}**! You are our **{server.membercount_nobots_ordinal}** member, invited by {inviter.mention}!
    .welcome on
    .welcome test
    ```
  </Tab>

  <Tab title="Welcome DM">
    ```bash theme={null} theme={null}
    .welcomedm message Hey {user.name}, welcome to **{server}**! Check out our rules in #rules-and-info.
    .welcomedm on
    .welcomedm test
    ```
  </Tab>
</Tabs>