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

# Welcome & Greet

> Beautiful automated messages for joins, leaves, boosts, and more.

## Overview

Flare's Welcome module sends automated messages when members join, leave, or boost your server. Messages support rich dynamic variables and can attach saved embeds for beautiful, branded greetings.

***

## Configuration

All greet types (`welcome`, `leave`, `boost`) share the same subcommand structure:

<Tabs>
  <Tab title="Welcome Messages">
    ```bash theme={null}
    /welcome enable #welcome
    /welcome message Hey {user}, welcome to {server_name}! {embed: welcome_card}
    /welcome test
    /welcome config
    /welcome disable
    ```

    **Aliases:** `welcomemsg`, `wlcm`
  </Tab>

  <Tab title="Leave Messages">
    ```bash theme={null}
    /leave enable #goodbye
    /leave message {user_name} left the server. {embed: leave_card}
    /leave test
    /leave config
    /leave disable
    ```

    **Aliases:** `leavemsg`, `farewell`
  </Tab>

  <Tab title="Boost Messages">
    ```bash theme={null}
    /boost enable #boosts
    /boost message Thank you {user} for boosting! 🎉
    /boost test
    /boost config
    /boost disable
    ```
  </Tab>
</Tabs>

**Required Permission:** `Manage Guild`

***

## Using Variables in Messages

You can make your greet messages dynamic using [Variables](/variables/overview):

* `{user}` — Mentions the user
* `{user_name}` — Username
* `{user_avatar}` — Avatar URL
* `{server_name}` — Server name
* `{server_membercount}` — Total member count

***

## Attaching Saved Embeds

Instead of plain text, you can attach a beautifully designed embed to your welcome message using the `{embed: name}` syntax.

<Steps>
  <Step title="Create a Saved Embed">
    ```bash theme={null}
    /embed create welcome_card
    ```

    Use the interactive editor to design your embed with title, description, color, images, and fields.
  </Step>

  <Step title="Attach it to Welcome">
    ```bash theme={null}
    /welcome message Welcome {user}! {embed: welcome_card}
    ```
  </Step>

  <Step title="Test It">
    ```bash theme={null}
    /welcome test
    ```
  </Step>
</Steps>

***

## Additional Greet Features

### Autorole

Automatically assign a role to new members on join:

```bash theme={null}
/autorole set @Member
/autorole remove
```

### Join Ping (Timed Greet)

Ghost-ping a new member in a specific channel, then delete the ping after a delay:

```bash theme={null}
/joinping enable #general
/joinping disable
```

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Welcome messages aren't sending">
    1. Ensure the module is enabled (`/welcome config`).
    2. Ensure Flare has `Send Messages` and `Embed Links` permissions in the welcome channel.
    3. Check that a message is actually set (`/welcome config` shows the current message).
  </Accordion>

  <Accordion title="Variables showing as raw text">
    You likely misspelled the variable. Use `/variables` to see the full list of supported placeholders.
  </Accordion>
</AccordionGroup>

## Related Pages

* [Variables Overview](/variables/overview)
* [Embeds Module](/modules/embeds)
* [Build a Welcome System Recipe](/recipes/build-a-welcome-system)