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

# Welcomer

> Greet new members with a message, a generated image, or both — plus goodbye messages and temporary greets.

Three modes on one page: **Welcome**, **Goodbye** and **Greet**.

<Note>
  All three share **one save bar**. Switching between them does not lose your edits — everything commits together when you save.
</Note>

## Welcome and Goodbye

Each has three tabs.

### Settings

The channel, whether the message is on, whether the image is on, and where the text sits relative to the image — before it, after it, or on it.

### Message

Three formats:

| Format                                  | Tier      |
| --------------------------------------- | --------- |
| **Message** — plain text                | Free      |
| **Embed Message**                       | **Basic** |
| **Advanced Message** — component layout | **Basic** |

<Note>
  On Starter, clicking Embed or Advanced opens the upgrade dialog rather than switching the tab. Nothing is hidden.
</Note>

Variables for welcome messages:

| Variable       | Inserts              |
| -------------- | -------------------- |
| `[User]`       | The member           |
| `[ServerName]` | Your server's name   |
| `[Inviter]`    | Who invited them     |
| `[Code]`       | The invite code used |
| `[UsersCount]` | The new member count |
| `[CountUrl]`   | A count image URL    |

Goodbye messages support `[User]`, `[ServerName]` and `[UsersCount]`.

<Warning>
  **The default welcome message contains `[Server]`, which is not a real variable** and will appear literally in your welcome messages. Replace it with `[ServerName]`.
</Warning>

<Warning>
  **Embed edits are discarded unless the message type is set to Embed when you save.** If you build an embed and then switch back to the Message tab before saving, the previous embed is written back over your work.

  Leave the message type on Embed while you edit it, then save.
</Warning>

### Image

A canvas editor. Set a background, position the member's avatar, their name and a line of text.

* Background: an uploaded image, or transparent
* Uploads up to **3 MB**, PNG, JPG or GIF
* Avatar: circle or square, with size and position
* Name and text: font size, colour, alignment, size and position

<Note>
  Long usernames are shortened on the image so they cannot overflow the canvas.
</Note>

<Tip>
  Use **Fit Stage** after uploading a background so the canvas matches the image, rather than stretching the image to a canvas of the wrong shape.
</Tip>

## Greet

A short mention posted when someone joins, which deletes itself.

* **Auto-delete** — never, or after 3, 5, 10, 15, 30 or 60 seconds
* **Greet channels** — a channel plus a message of up to 500 characters, one row per channel

<Info>
  Greet channels: **5** on Starter, **15** on Basic, unlimited on Max.
</Info>

<Warning>
  **On Black tier, the page shows "Unlimited" greet channels but saving more than 5 is rejected.** This is a known defect in the limit table. Keep Black servers at 5 greet channels until it is corrected.
</Warning>

<Tip>
  Greet is for a quick "welcome @member 👋" in your busiest chat channel, where a full welcome card would be intrusive. Use it alongside a proper welcome message in a dedicated channel, not instead of one.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing is posted when someone joins">
    Check the Welcomer module is on in [Server Setup](/en/server-management/setup), a channel is set, the message switch is on, and Vetox can send messages and attach files in that channel.
  </Accordion>

  <Accordion title="The message posts but the image does not">
    Vetox needs **Attach Files**. Also check the image switch on the Settings tab.
  </Accordion>

  <Accordion title="`[Server]` appears literally in my welcome message">
    It is not a variable. Change it to `[ServerName]`.
  </Accordion>

  <Accordion title="My embed keeps reverting">
    Set the message type to Embed and keep it there while you save.
  </Accordion>

  <Accordion title="Saving a Black-tier greet setup fails with a premium error">
    The greet channel cap misreads Black tier. Reduce to 5 channels.
  </Accordion>

  <Accordion title="`[Inviter]` is blank">
    Vetox needs **Manage Server** to read invites and work out who invited whom.
  </Accordion>
</AccordionGroup>

<Card title="Auto-Roles" icon="user-plus" horizontal href="/en/engagement/auto-roles">
  Give roles on join as well as a welcome.
</Card>