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

# Welcome

> Have your character greet people who join your Discord server, with a message it writes in character, a welcome card with their avatar and name, or both.

# Welcome

**Welcome** lets your character greet people who join your server. It can send:

* a **greeting message** that it writes fresh for every new member, in its own voice, following your instructions
* a **welcome card**: an image with the new member's avatar and name

You choose whether the welcome goes to a channel, to the new member's direct messages, or both. Welcome settings belong to one server, so each server can greet people differently.

To open it, select **Discord** in the sidebar, then go to **Server** → **Welcome**.

> [!NOTE]
>
> Welcome works on the server you chose on the [Server Overview](https://docs.aurinfer.com/Integrations/Discord/SERVER/overview.md#choose-a-server). If you haven't chosen one, the page shows **Pick a Server First**. Click **Go to Overview**, pick the server, then come back.

***

## Set up Welcome

The first time you open **Welcome** for a server, you see **Set Up Welcome**, which walks you through four steps.

**1. Where should your character welcome people?**

Choose **Channel** to post where everyone sees it, **Direct message** to send a private hello, or **Both**. If you chose a channel, pick it under **Welcome channel**.

**2. What should your character say?**

Leave **Send a greeting message** on and write instructions for the greeting. To get started, click one of the presets next to **Start from**: **Warm**, **Hype**, **Cozy** or **Short**. You can use placeholders such as `[user]` and `[serverName]` (see [Placeholders](#placeholders)).

**3. Add a welcome card**

Turn on **Send a welcome card** if you want one. Pick a **Layout** and a **Background**, choose **How it's sent**, and decide whether to **Mention them on the card**. You can fine-tune the design later.

**4. Ready to go**

Check the summary of **Where**, **Greeting** and **Card**, then click **Turn on welcome**.

You need at least one of the greeting message or the welcome card. You can change everything later.

***

## The Welcome page

After setup, the **Welcome** page shows all your settings. Changes save automatically.

The switch at the top turns welcomes **On** or **Paused** without losing your settings.

### Delivery

| Setting | What it does |
| - | - |
| **Where to Welcome** | **Channel**, **DM** or **Both**. Members who turned off DMs from server members don't get the direct message. |
| **Welcome Channel** | The channel where welcomes are posted. Your character needs **Send Messages** there, and **Attach Files** if you send a welcome card. |

If you use a channel but haven't picked one, the page reminds you. Until you pick one, nobody gets a channel welcome.

### Greeting

Turn **Greeting Message** on to have your character write a greeting for each new member. It writes it using your **Instructions**, what it remembers about the person, and the mood of the channel.

Write your **Instructions** in the box. Click a placeholder under the box to insert it where your cursor is. If you leave the instructions empty, your character greets people in its own style.

Turn the greeting off to send only the welcome card. The greeting stays on while the card is off, so members always get something.

### Welcome Card

The preview shows how the welcome looks in Discord, using your own profile as the new member. Click **Customize** to design the card. See [Customize the welcome card](#customize-the-welcome-card).

| Setting | What it does |
| - | - |
| **Send a Welcome Card** | Sends the card with every welcome. It stays on while the greeting is off. |
| **Message Layout** | When you send both: **Card first, then greeting** sends two messages, and **One message** sends the greeting with the card attached. |
| **Mention on the Card** | Pings the new member with the card so they see it. If the greeting follows in a separate message, it doesn't ping them a second time. |

### Behavior

| Setting | What it does |
| - | - |
| **Ignore Bots** | Skips other bots that join the server. |
| **Delay** | How long your character waits before welcoming someone, from **Instantly** up to 30 seconds. A short pause feels more natural. |
| **Welcome Chance** | The share of new members who get welcomed, from 5% to 100%. Lower it in very busy servers so the welcome channel doesn't fill up. |

Waves of people joining at once are already slowed down automatically, so you don't need to lower **Welcome Chance** for that.

### Danger Zone

**Remove welcome** turns off welcomes in this server and deletes your instructions, card design, uploaded background and welcome counts. Messages already sent stay in Discord. To stop welcomes for a while instead, use the **On** / **Paused** switch.

***

## Customize the welcome card

Click **Customize** in the **Welcome Card** section to open **Customize Welcome Card**. The preview at the top is the exact image your character sends. Use **Preview as** to see it on Discord's dark or light theme.

| Section | What you can change |
| - | - |
| **Layout** | **Classic** puts the avatar beside the name, **Centered** puts it above the name, and **Framed** adds a rounded border with see-through corners. |
| **Frame** | For the **Framed** layout: **Border color**, **Thickness** (**Thin**, **Regular** or **Bold**), **Corners** (**Soft**, **Round** or **Extra round**) and **Inner panel**, a soft panel behind the avatar and name. |
| **Background** | **Character banner**, your own image (**Upload image**), a blurred **Server icon**, or a **Solid color**. |
| **Adjust** | **Blur** and **Darken** soften a busy background so names stay easy to read. |
| **Accent** | The color of the ring around the avatar and the caption, and of the frame on the **Framed** layout. |
| **Text** | Three lines: **Caption**, **Headline** and **Subline**. Leave a line empty to hide it. |

Click **Save card** to apply your design. If you close the window with unsaved changes, you're asked whether to discard them.

### Use your own background

Click **Upload image** and choose a JPG, PNG, WebP or GIF image. Drag to position it and zoom to fit, then click **Use image**. Cards are 1100×500, so an image at least that size looks sharpest. Your image is checked before it goes live, and images that break the rules can't be used.

***

## Placeholders

Placeholders are replaced with real details for each new member.

| Placeholder | Replaced with | Greeting | Card |
| - | - | - | - |
| `[user]` | The new member | Yes | No |
| `[username]` | Their username | Yes | Yes |
| `[displayName]` | Their display name | Yes | Yes |
| `[serverName]` | Your server's name | Yes | Yes |
| `[memberCount]` | How many members your server has | Yes | Yes |

For example, a greeting instruction could be: *Welcome \[user] to \[serverName]! Make them feel at home and ask what brought them here.* A card subline could be: *Member #\[memberCount]*.


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