# Welcome

The Welcome module greets new members and helps them find the right place to start. It can post channel messages, use embeds, include images, assign auto-roles, and optionally send leave messages.

# Features

• Welcome messages in a selected channel.
• Leave messages when members exit.
• Custom text and embed styling.
• Optional welcome images or cards.
• Auto-role assignment for new members.
• Variables for member, server, and count values.

# Setup

1. Open the dashboard.
2. Select your server.
3. Go to Welcome.
4. Choose the welcome channel.
5. Configure the message text or embed.
6. Add an auto-role if needed.
7. Enable the module and test with a controlled join if possible.

# Variables

Welcome text can use server and member placeholders where supported. Common examples include:

Available variables may vary by message type. The dashboard should show supported variables near the editor.

# Auto-role requirements

For auto-roles, Strom needs:

• Manage Roles.
• A bot role higher than the assigned role.
• No channel-specific override blocking command responses or logs.

Do not use auto-role to grant staff permissions unless you are intentionally building a restricted onboarding flow.

# Best practices

• Keep welcome text short and useful.
• Link rules, roles, support, and getting-started channels.
• Keep welcome and audit-log channels separate.
• Avoid pinging staff on every join unless the server is small.
• Use auto-roles for member access only after your role hierarchy is correct.

# Troubleshooting

# Welcome messages are not sending

Check that the module is enabled, a channel is selected, and Strom has View Channel, Send Messages, and Embed Links.

# Auto-role is not assigned

Move the Strom Bot role above the target role and confirm Manage Roles is granted.

# Images do not appear

Confirm image URLs are public and Strom has Attach Files if the module sends generated cards.