Welcome Plugin — Ori Discord Bot
What does the welcome plugin do?
Section titled “What does the welcome plugin do?”Ori’s welcome plugin sends a customizable message to a channel of your choice the moment a new member joins your Discord server. Configure text or embed format, custom colors, and variables like {user} and {server.members} from the dashboard. No slash commands required. Works immediately after enabling — zero setup time.
Choose between a plain text message or a rich embed with custom colors, thumbnail, and footer. Use variables to personalize each welcome — mention the new member, show the server name, display the current member count. Preview your message in the dashboard before it goes live, then hit the test button to send a real message to your channel.
How do I set up the welcome plugin?
Section titled “How do I set up the welcome plugin?”- Open the Ori dashboard at oribot.org
- Select your server
- Click Plugins in the sidebar
- Find Welcome and click the toggle to enable it
- Click into Welcome to open its settings
- Select the channel where welcome messages should appear
- Choose your format — text or embed
- Write your welcome message using variables like
{user}and{server} - If using embed format, pick a color (or use your server’s brand color)
- Click Test to send a real welcome message to your channel
- Verify it looks right. Done.
What it looks like
Section titled “What it looks like”In the dashboard
Section titled “In the dashboard”What your members see
Section titled “What your members see”How do I customize welcome messages?
Section titled “How do I customize welcome messages?”Message format
Section titled “Message format”Choose between text (plain message) or embed (rich message with color, thumbnail, and footer). Embeds look more polished and support more formatting options.
Variables
Section titled “Variables”Insert dynamic content into your message using variables:
| Variable | What it outputs | Example |
|---|---|---|
{user} | @mentions the new member | @zachary |
{user.name} | Member’s display name (no mention) | zachary |
{server} | Server name | My Community |
{server.members} | Current member count | 3,241 |
Variables work in both text and embed formats. They resolve automatically when the message is sent.
Embed options
Section titled “Embed options”When using embed format, you can customize:
- Color — pick any hex color or use your server’s brand color
- Title — the bold heading at the top of the embed
- Description — the main message body (supports variables)
- Thumbnail — a small image in the corner of the embed
- Footer — small text at the bottom of the embed
Live preview
Section titled “Live preview”The dashboard shows a live preview of your welcome message as you edit it. Variables display with sample values so you can see exactly how the final message will look.
What variables can I use in welcome messages?
Section titled “What variables can I use in welcome messages?”See the full variables reference. The welcome plugin supports all standard variables: {user}, {user.name}, {server}, and {server.members}.
Limits
Section titled “Limits”- Maximum message length: 2,000 characters (Discord’s limit)
- Maximum embeds per welcome message: 1
- One welcome message per server (same message for all new members)
- Welcome messages send to one channel only
What the welcome plugin cannot do
Section titled “What the welcome plugin cannot do”Ori’s welcome plugin cannot send DMs to new members. Welcome messages are sent to a server channel only. Discord’s anti-spam policies make DM-based welcome messages unreliable and Ori does not attempt them.
Ori’s welcome plugin cannot send different messages based on how a member joined. All new members receive the same welcome message regardless of whether they joined via invite link, server discovery, or any other method.
Ori’s welcome plugin cannot delay messages. The welcome message sends immediately when a member joins. There is no scheduling or delay option.
Ori’s welcome plugin cannot send to multiple channels. Pick one channel for welcome messages. If you need messages in multiple channels, consider using a different tool for the additional channels.
Ori’s welcome plugin cannot send images or file attachments. Embed thumbnails are supported, but you cannot attach files or inline images to the welcome message.
Ori’s welcome plugin cannot trigger on bot joins. Welcome messages only fire when human members join the server.
Troubleshooting
Section titled “Troubleshooting”My welcome message isn’t sending
Check that:
- The welcome plugin is enabled in the dashboard
- A channel is selected in the plugin settings
- Ori has Send Messages and Embed Links permissions in that channel
- Ori’s role is not blocked by channel permission overwrites
Variables are showing as literal text like {user}
Check the syntax. Variables must be exactly {user}, not { user }, $user, or <user>. No spaces inside the braces.
The embed color looks wrong
Discord renders colors slightly differently on mobile vs desktop. The color you set in the dashboard is the exact hex value sent to Discord — any rendering differences are on Discord’s side.
The test button works but real joins don’t trigger a message
Verify Ori has the View Channel permission in the welcome channel. Also check that the plugin toggle is set to enabled, not just configured.
Frequently asked questions
Section titled “Frequently asked questions”Is Ori’s welcome plugin free? Yes. Every feature of the welcome plugin is free for all servers with no usage limits.
Can I use the welcome plugin alongside other bots’ welcome systems? Yes. Ori’s welcome plugin operates independently. Running another bot’s welcome system alongside it will result in two welcome messages — most admins disable the other bot’s version.
Can I preview my welcome message before it goes live? Yes. The dashboard shows a live preview as you edit. You can also click the Test button to send a real message to your channel.
Does the welcome plugin work for large servers? Yes. Ori processes joins in real time with no queue or delay regardless of server size.
Can I mention a role in the welcome message? You can type a role mention manually in the message text, but the welcome plugin does not have a dedicated role-mention variable.