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

# Welcome Message

> Greet every member who joins, with a template or an embed script.

```text theme={null}
/config channel welcome-channel #welcome
/config welcome message "Welcome {user} to {server} · member #{count}"
/config preview setting:welcome-message
```

Default text is `hi {user}`. Nothing posts until `welcome-channel` points at a channel the bot can
write to.

## What's available

| Token | Output |
| - | - |
| `{user}` | Mention of the new member |
| `{user.name}` · `{user.display}` | Username · display name |
| `{user.avatar}` | Avatar URL |
| `{user.created}` · `{user.created.relative}` | Account creation date · age |
| `{user.join_position}` · `{user.join_position.ordinal}` | Their join number · `1,234th` |
| `{server}` · `{guild.member_count}` | Server name · member count |
| `{count}` | Member count, short form |

## Adding the joined member

`{user}` already mentions them. To also hand out a role on join, set the autorole:

```text theme={null}
/config role autorole @Member
```

That runs independently of the message, so you can have one without the other. Clear it with
`/config role autorole` and no role.

## Notes

* The message is sent once per join · no replay for members who joined while the bot was offline.
* `{server}` and `{count}` come from live guild data, so they're always current.
* Reset the text with `/config welcome reset`; the channel stays set.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.