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

# Welcome System

> Configure automated greetings and farewells for your Discord server.

# Welcome System

Set up customized welcome and goodbye messages to greet new members and acknowledge departures. Veronica's welcome system supports dynamic variables, custom channels, and rich embed formatting.

## Quick Setup

<Steps>
  <Step title="Enable Welcome Messages">
    Initialize the welcome system for your server.

    <CodeGroup>
      ```bash Slash theme={null}
      /welcome setup
      ```

      ```bash Prefix theme={null}
      ,welcome setup
      ```
    </CodeGroup>

    <Check>System initialized and ready for configuration.</Check>
  </Step>

  <Step title="Set Welcome Channel">
    Choose where welcome messages should be sent.

    ```bash theme={null}
    /welcome channel #welcome
    ```

    <Check>Channel linked successfully.</Check>
  </Step>

  <Step title="Customize Message">
    Create your welcome message with dynamic variables.

    ```bash theme={null}
    /welcome message Welcome {user.mention} to {server.name}!
    ```

    <Check>Custom message saved.</Check>
  </Step>

  <Step title="Test Configuration">
    Preview how your welcome message will look.

    ```bash theme={null}
    /welcome test
    ```

    <Check>Verification complete!</Check>
  </Step>
</Steps>

## Dynamic Variables

Use these variables in your welcome and goodbye messages:

| Variable               | Description         | Example Output    |
| :--------------------- | :------------------ | :---------------- |
| `{user.mention}`       | Mentions the user   | @Username         |
| `{user.name}`          | User's display name | Username          |
| `{user.tag}`           | User's full tag     | Username#1234     |
| `{user.id}`            | User's Discord ID   | 123456789         |
| `{server.name}`        | Server name         | My Awesome Server |
| `{server.membercount}` | Total member count  | 1,234             |
| `{server.id}`          | Server ID           | 987654321         |
| `{date}`               | Current date        | January 30, 2026  |
| `{time}`               | Current time        | 3:45 PM           |

## Configuration Options

<AccordionGroup>
  <Accordion title="Welcome Messages">
    Configure messages sent when users join.

    **Commands:**

    * `/welcome enable` - Enable welcome messages
    * `/welcome disable` - Disable welcome messages
    * `/welcome message [text]` - Set welcome message
    * `/welcome channel [#channel]` - Set welcome channel
    * `/welcome embed [true/false]` - Use embed format
  </Accordion>

  <Accordion title="Goodbye Messages">
    Configure messages sent when users leave.

    **Commands:**

    * `/goodbye enable` - Enable goodbye messages
    * `/goodbye disable` - Disable goodbye messages
    * `/goodbye message [text]` - Set goodbye message
    * `/goodbye channel [#channel]` - Set goodbye channel
  </Accordion>

  <Accordion title="Auto-Roles">
    Automatically assign roles to new members on join. See the [Auto-Roles Guide](/setups/auto-role) for detailed setup and security information.
  </Accordion>

  <Accordion title="DM Welcome">
    Send a private welcome message to new members.

    **Commands:**

    * `/dmwelcome enable` - Enable DM welcome
    * `/dmwelcome message [text]` - Set DM message
  </Accordion>
</AccordionGroup>

## Example Configurations

<CodeGroup>
  ```text Simple Welcome theme={null}
  Welcome {user.mention} to {server.name}! 🎉
  We now have {server.membercount} members!
  ```

  ```text Detailed Welcome theme={null}
  👋 Welcome to **{server.name}**, {user.mention}!

  You are member #{server.membercount}

  Please read our rules in #rules and introduce yourself in #introductions!
  ```

  ```text Embed Welcome theme={null}
  {
    "title": "Welcome to {server.name}!",
    "description": "Hey {user.mention}, glad to have you here!",
    "color": "#8B5CF6",
    "thumbnail": "{user.avatar}",
    "footer": "Member #{server.membercount}"
  }
  ```
</CodeGroup>

## Advanced Features

### Role-Based Welcome

Send different welcome messages based on how users joined:

<CardGroup cols={2}>
  <Card title="Invite Tracking" icon="link">
    Track which invite link was used and customize messages accordingly.
  </Card>

  <Card title="Verification Level" icon="shield-check">
    Different messages for verified vs. unverified members.
  </Card>

  <Card title="Boost Welcome" icon="rocket">
    Special message for server boosters.
  </Card>

  <Card title="Bot Detection" icon="robot">
    Separate handling for bot accounts.
  </Card>
</CardGroup>

### Image Backgrounds

Create custom welcome images with user avatars:

```bash theme={null}
/welcome image enable
/welcome image background [url]
/welcome image text Welcome {user.name}!
```

## Best Practices

<Note>
  Keep welcome messages concise and friendly. Include essential information like rules channel, introduction channel, and server guidelines.
</Note>

<Warning>
  Avoid mentioning `@everyone` or `@here` in welcome messages as this will ping all members every time someone joins.
</Warning>

<Tip>
  Use embed format for more visually appealing welcome messages with colors, images, and structured information.
</Tip>