# Welcome messages

> Greet new Discord members with Based: custom welcome title and message, placeholders, rules and info channel links, join roles and test previews.

URL: https://www.jalkarna.in/based/docs/welcome/  
Last updated: 2026-11-16

The welcome module greets each new member in a channel you choose. It is off by default.

## Writing the greeting
The message and title support placeholders: `{member}` (the new member), `{server}` and `{member_count}`. Add links to your rules, information and announcements channels so newcomers know where to start. Only the new member can be pinged; roles, @everyone and @here never are.

## Join roles
Give new members roles automatically with **Join roles**. Based needs **Manage Roles**, and its own role must sit above the roles it gives. See [roles and role hierarchy](https://www.jalkarna.in/based/learn/discord-roles-and-role-hierarchy/).

## Testing
`/greet` turns welcomes on or off, sets the channel and sends a test greeting. A **welcome manager role** can preview greetings; changing settings still needs Manage Server.

## Settings
Change these in the [dashboard](https://www.jalkarna.in/based/dashboard/) or with `/setup` in Discord. They apply to one server at a time.

| Setting | Default | What it does |
|---|---|---|
| Enabled | Off | Turn this feature on for this server. |
| Welcome channel | Not set | Where Based greets new members. |
| Welcome manager role | Not set | Optional. This role can preview the greeting. Changing settings still needs Manage Server. |
| Welcome message | Welcome {member}! | You can use {member}, {server} and {member_count}. Only the new member can be pinged. |
| Welcome title | Welcome to {server} | You can use {server} and {member_count}. |
| Rules channel | Not set | Optional. Adds a link to your rules channel. |
| Information channel | Not set | Optional. Adds a link to your information channel. |
| Announcements channel | Not set | Optional. Adds a link to your announcements or giveaways channel. |
| Mention the joining member | On | Ping the new member in the greeting. Roles, @everyone and @here are never pinged. |
| Join roles | Not set | Optional roles given to new members. Based needs Manage Roles and a role above these. |

## Permissions Based needs
For this module Based's role needs: **View Channel**, **Send Messages**, **Embed Links**. See [permissions](https://www.jalkarna.in/based/docs/permissions/) for how to grant them only where they are needed.

## Commands
Every command works as a slash command and with the text prefix (default `.`), so `/greet` and `.greet` do the same thing.

### /greet
Configure or test member welcome greetings.

- Usage: `/greet [enabled] [channel] [test]`
- `enabled`: Enable welcome greetings
- `channel`: Channel for welcome greetings
- `test`: Send a preview greeting
- Who can use it: Members with Manage Server, in servers only

