> For the complete documentation index, see [llms.txt](https://infinitybot.gitbook.io/infinitybot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitybot.gitbook.io/infinitybot-docs/onboarding/welcome-leave-and-boost-messages.md).

# Welcome, Leave & Boost Messages

Welcome, leave & boost messages can be user as a "welcome", "goodbye" or "thank you" message when someone joins the server, leaves the server or boosts the server

## Setup

There is one command for all features below: `/setup welcomer`. Depending on the "action" option input, the command will set up or remove a message.

| Command Option Name | Function                                                                                       |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| action              | The action that you want to take. (See table below)                                            |
| channel             | The channel were you want to send the message when someone joins, leaves or boosts the server. |
| message-content     | The content of your message.                                                                   |
| embed               | In this option you can select if you want to send the messages as embed or not                 |

| Option "action" input    | Command action                                |
| ------------------------ | --------------------------------------------- |
| Enable welcome messages  | Set up a [welcome message](#welcome-messages) |
| Enable leave messages    | Set up a [leave message](#leave-messages)     |
| Enable boost thank-you's | Set up a [boost message](#boost-messages)     |

You can also disable messages by replacing "Enable" with "Disable" in the "action" option.

If you select "Yes" in the embed option, you will get the form below:

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FCrkgnbQIOoasBv2aYkFJ%2Fimage.png?alt=media&amp;token=6b2bbfe4-101c-4ea6-b1f1-6b3bbe2eeaf1" alt="" width="367"><figcaption></figcaption></figure>

| Form question    | Function                                                                                                                            |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Embed title      | In this question you can enter the title of your embed                                                                              |
| Base content     | In this question you can enter the base content of your embed. This will be set to the message-content option at first              |
| Embed image link | In this question you can enter an image link for your embed. You can also enter `[user]` to make the bot use the avatar of the user |

### Welcome Messages

You can set up welcome messages with the `/setup welcomer` commans if you select "Enable welcome messages" as action.

### Leave Messages

You can set up leave messages with the `/setup welcomer` commans if you select "Enable leave messages" as action.

### Boost Messages

You can set up boost messages with the `/setup welcomer` commans if you select "Enable boost thank-you's" as action.

## Variables

There is a set of variables that you can use in the welcome, leave or boost messages. Variables are text inputs that the bot will replace with other content. You can find an overview of all usable variables for the messages:

| Variable      | Function                                                                                                       | Example output                                                                                                                                                                                                                                            | Example of usage                   |
| ------------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| `[user]`      | Ping the user that joined, left or boosted the server.                                                         | @user                                                                                                                                                                                                                                                     | \[user] welcome!                   |
| `[user_name]` | Show the user name of the user that joined, left or boosted the server.                                        | notcastel                                                                                                                                                                                                                                                 | \[user\_name] left the server.     |
| `[server]`    | Show the name of the server.                                                                                   | 🪐Cosmos Lounge✨                                                                                                                                                                                                                                          | Welcome on \[server]               |
| `[members]`   | Show the member count of the server. (Does not work for boost messages)                                        | 24                                                                                                                                                                                                                                                        | Server now has \[members] members. |
| `[user]`      | Show the avatar of the user that joined, left or boosted the server. (Only works in image links in the embeds) | <img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2Ft1c1J2J8ks25zplORBH7%2Fimage.png?alt=media&amp;token=149af7cc-952b-4b7f-a56d-78f32a421d35" alt="" data-size="original"> | \[user]                            |
