BotGhost Documentation
Support ServerYouTubeMarketplaceBotGhost PremiumSign in
  • Welcome to BotGhost
  • Guidelines & Privacy
  • Changelogs 2025
    • Changelogs 2024
    • Changelogs 2023
  • BotPanel Documentation
  • Getting Started
    • Create Your First Bot
      • Create Your Second Bot
    • Invite Your Bot
    • Standard Practices
      • Advanced Practices
    • Mobile Application (PWA)
  • Support
    • BotGhost Support
    • Frequently Asked Questions
  • Premium & Priority Hosting
    • Priority Hosting
    • Our Premium Features
    • Plans & Payment Methods
    • Manage Your Subscription
    • Upgrade Your Bot
    • Refund & Cancellation Policy
    • Beta Features
  • General Settings and Collaboration
    • Settings
    • Collab
    • Status
    • Active Developer Badge
    • Marketplace
  • Custom Commands & Events
    • Command & Event Builder
      • Sharing Commands and Events
      • Advanced Options
    • Actions
      • Message Actions
        • Send or Edit a Message
          • Button
          • Select Menu
        • Edit a Button or Select Menu
        • Send a Form
        • Delete a Message
        • Publish a Message
        • React to a Message
        • Pin a Message
      • Custom Variable Actions
        • Set Variable
        • Run Equation on Variable
        • Delete Variable
      • API Actions
        • Send an API Request
        • Execute an IFTTT Trigger
      • Loop Actions
        • Run a Loop
        • Stop a Loop
      • Voice Actions
        • Join a Voice Channel
        • Leave a Voice Channel
        • Voice Move a Member
        • Voice Kick a Member
        • Voice Mute or Unmute a Member
        • Voice Deafen or Undeafen a Member
      • Role Actions
        • Add Roles
        • Remove Roles
        • Create a role
        • Delete a role
        • Edit Role
      • Channel Actions
        • Create a channel
        • Edit a channel
        • Delete a channel
      • Thread and Forum Actions
        • Create a Thread
        • Edit a Thread
        • Delete a Thread
      • Server Actions
        • Kick a member
        • Ban a member
        • Timeout a member
        • Change a members nickname
        • Purge Messages
        • Create Server Invite
      • Other Actions
        • Wait before running another action
        • Manipulate some text
        • Send an error log message
        • Set a unique variable
        • Change the Bot's Status
        • Note
      • [LEGACY] Reply Actions
        • Plain Text Reply
        • Embed Reply
        • Random Reply
        • Send a message to a channel
        • Direct Message a User
        • Send a Message with attached buttons
          • Buttons
        • Send a message with a select menu
          • Menu Option
    • Conditions
      • Comparison Condition
      • Permission Condition
      • Chance Condition
      • Channel Condition
      • Role Condition
      • User Condition
      • Premium Check Condition
    • Options
      • Text Option
      • Number Option
      • User Option
      • Channel Option
      • Role Option
      • Choice Option
      • Attachment Option
    • Events
      • Timed Events
      • Webhooks
    • Data Storage
      • Collections
      • Objects
    • IFTTT
    • Variables
  • Server Management
    • Moderation
    • Discord Automod
    • Tickets
    • Welcomer
    • Verification
    • Statistic Channels
    • Modmail
    • Auto-React
    • Sticky Roles
    • Emoji Manager
    • Polls Filter
    • Automod
    • Logging
  • Messages
    • Timed Messages
    • Reaction Roles
    • Autoresponder
    • Embed Builder
    • Sticky Messages
    • Polls
    • Global Chat
    • Media Channels
  • AI
    • ChatGPT
    • Image Generation
  • Game Integrations
    • Roblox Verification
  • Social Integrations
    • YouTube
    • Twitch
  • Community Engagement
    • Leveling
    • Temp Voice Channels
    • Suggestions
    • Invite Tracker
    • Starboard
    • Question Of The Day
    • Giveaways
  • Fun Modules
    • Economy & Minigames
    • Birthdays
    • Counting
  • Utility
    • Translation
    • Weather
Powered by GitBook
On this page
  • Common Issues
  • Message not sending
  • Welcome card not working
  • Watch the Tutorial
  • Settings
  • Welcome Card
  • Message on Join
  • Direct message on Join
  • Add Role on Join
  • Message on Leave
  • Message on Kick
  • Message on Ban
  • Events

Was this helpful?

  1. Server Management

Welcomer

Give your new members a warm welcome!

Last updated 1 month ago

Was this helpful?

Some of the features of this module require a to function. You can however use the module with a free subscription.

The module will allow you to send custom welcome banners, messages, reactions, and add roles to users when they join the server. This module will also allow you to send a message when a user is kicked or banned, all in one.

Common Issues

Message not sending

If your welcome message is not being sent, try the following steps:

1

Check the Discord server permissions of your bot: make sure your bot has the "Send messages" and "View Channel" permissions and that there are no overwrites for the selected channel, or just give your bot the "Administrator" permissions.

2
3

Welcome card not working

If the welcome card isn't working/sending you can try:

1

Check if the image URL is a valid file type (PNG, JPG, JPEG). A valid image url should end with .png, .jpg or .jpeg.

2

Don't use Discord attachment links: after some time, they expire and cannot be used outside of Discord (including BotGhost).

3

Watch the Tutorial


Settings

Welcome Card

Customize the card to your liking. You can configure many different aspects of the card as below.

[👑] Welcome Card

Type
Details

Disabled

If the welcome cards are disabled then no cards will be sent when a user joins the server.

Send to a channel

This selection type will send the welcome card to a specified channel when someone joins.

Message the user

This dropdown type will send a direct message to the user.

Send to a channel and message the user

If this option is selected it will send the message to both the channel and the user's direct messages.

[👑] Channel

Select a channel from your server to send the welcome card to.

[👑] Background

Choose a custom background from your card. You have 3 options for this. Depending on the option chosen it will change the background color.

If "Plain Color" is chosen, you will simply choose from the default color panel.

[👑] Background - Color

This allows you to select the background color that will be used for the card.

Example Card

If "Default Background" is chosen you can pick one of the default background cards BotGhost provides, available in 8 colors including Red, Yellow, Blue, Purple and more.

[👑] Background - Default Card Color

This setting allows you to pick your favorite color for the default background card.

Example Cards

If "Custom Background" is chosen then the card can be a color or any image you provide by entering it into the field below.

[👑] Background - Image

Paste the URL of the image that will be used as a background. Make sure it's a valid image URL (ends with .png, .jpg or .jpeg). You should not use Discord attachment links as they expire after some time and cannot be used outside the platform. The recommended size of the image is 1024x500 pixels.

Example Card

[👑] Title Color

This section represents the color for the title of the welcome card.

[👑] Description Color

This section represents the color for the description of the welcome card.

[👑] Avatar Border Color

This section represents the color for the avatar border of the welcome card.

[👑] Banner Title

[👑] Banner Description

[👑] Channel Reactions

Choose up to 5 reactions that can be added to the welcome card message.

[👑] DM Reactions

Choose up to 5 reactions that can be added to the welcome card Direct message.

Message on Join

When enabled, this action allows for a message to be sent to a specific channel.

Channel

Select the channel from this dropdown for the message to be sent to.

Welcome Message

Reactions

Choose up to 5 reactions that can be added to the message.

Direct message on Join

When enabled, this action allows for a message to be sent as a direct message to the user who joined.

Welcome Direct Message

Reactions

Choose up to 5 emoji that can be added to the direct message.

Add Role on Join

When this switch is enabled, it acts as an auto-role feature for the server, adding any roles from the server to the user who joined.

Roles to add on join

This section is where you can add any roles you wish from any server the bot is in. The roles will be added to the user from the respective server they joined.

Wait for rules acceptance

Enabling this switch will add the roles only after the user has accepted the server rules from the membership screening page. The server must have this setup for this to function correctly.

Message on Leave

Define whether you wish to enable or disable the message that gets sent when a user leaves the server.

Channel

Select the channel from the dropdown that the message will get sent to upon a user leaving.

Leave message

Reactions

Choose up to 5 reactions to be added to the message.

Message on Kick

Define whether you wish to enable or disable the message that gets sent when a user is kicked from the server.

Channel

Select the channel from the dropdown that the message will get sent to upon a user that gets kicked.

Kick message

Reactions

Choose up to 5 reactions to be added to the message.

Message on Ban

Define whether you wish to enable or disable the message that gets sent when a user is banned from the server.

Channel

Select the channel from the dropdown that the message will get sent to upon a user that gets banned.

Ban message

Reactions

Choose up to 5 reactions to be added to the message.


Events

In this area, you can view and modify the events of the Welcomer module. Below you may find some information on each event of the module.

Joins Handler

This event contains the welcoming card, the message on join, and the role addition.

Leaves and Kicks Handler

These events contain the message on leave and the message on kick.

Bans Handler

This event contains the message on ban.


It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intended.

Additionally, a copy of the edited commands / events will be created if you update the module.

Experiencing issues with the module? Check out the common issues below. If your issue is not listed in this page, make sure your module is updated to the latest version. If you are still experiencing issues with the module, join our to ask for further help.

Check if your bot intents (message intent) are enabled on the . Ensure the message intent is also enabled in the settings page. See for more info.

If you're still experiencing issues, join our to ask for further help.

If you're still experiencing issues, join our for further assistance.

Features in this section are limited to users.

This section is how you can edit the banner title for the welcome card. can be used.

This field is how you can edit the banner's description. can be used as well.

This field is where you input the welcome message for when the user joins. You are able to pick from either or response types. You are also able to use the {card} variable inside the image url section of the embed response type to show your welcome card in the same message. Some can also be used, such as {user}.

This field is where you input the welcome message for when the user joins. You are able to pick from either or response types. You are also able to use the {card} variable inside the image url section of the embed response type to show your welcome card in the same message. Some can also be used, such as {user}.

This field is where you will input the message that gets sent when the user leaves. can be used. You can also choose from either a or response type.

This field is where you will input the message that gets sent when the user is kicked. can be used. You can also choose from either a or response type.

This field is where you will input the message that gets sent when the user is banned. can be used. You can also choose from either a or response type.

support server
support server
support server
Variables
Variables
plain text
embed
variables
plain text
embed
variables
Variables
plain text
embed
Variables
plain text
embed
Variables
plain text
embed
Welcomer
Discord Developer Portal
Premium
Premium Subscription
Privileged Intent Options
Welcome Card reference