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
  • Birthdays are not being detected
  • Settings
  • General Settings
  • Birthday Card
  • Birthday Message
  • Add Role on Birthday
  • /birthday showcase Command
  • Commands Permissions
  • Module Variables
  • Commands
  • Events

Was this helpful?

  1. Fun Modules

Birthdays

Wish your members a Happy Birthday!

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 allows users to set their birthdays, view users' birthdays, and receive automatically personalized birthday wishes.

Common Issues

Birthdays are not being detected

If no birthday message gets sent on an user's birthday, they don't receive their birthday role or they aren't able to use the /birthday showcase command, please try the steps below.

1

Ensure the module is updated to the latest version. You can update it by clicking the "Update Module" button at the top of the settings page of the module.

2
3

Settings

General Settings

In this area, you can setup and customize the general settings for the commands and events of this module.

Timezone

If you want to know more about timezones, the following links may be helpful:

Time

Here you may choose the time that birthday wishes will go off on a users' birthday. This will sync to the timezone you chose above.

Save Birth Year

Here you may choose whether the birth year of a user should be allowed to save, not be allowed to save, or be required to save.

Embeds Color

Here you may choose the color for the embeds of the Birthdays module. This will be used in all messages.

Birthday Card

In this area, you can setup and customize a custom card that can be used across all messages of the module using the {card} variable.

[👑] Enable Custom card

This toggle option allows you to enable the {card} variable

[👑] Background

This setting allows you to set the background type for your card. Below you may find some information on each background type.

By selecting this option, the default background image will be used. Cards generated with the default background will look like this:

By selecting this option, you will be able to select a custom plain color for your card's background.

The following settings will appear:

[👑] Background Color

Here you may choose the color for the background on the custom card.

By selecting this option, you will be able to paste a custom image link for your background

The following settings will appear:

[👑] Background Image

Here you may set the background image on the custom card. This must be a valid image URL.

[👑] Title Color

Here you may choose the font color for the "title" text on the custom card.

[👑] Description Color

Here you may choose the font color for the "description" text on the custom card.

[👑] Avatar Border Color

Here you may choose the color for the circular border around the user's avatar on the custom card.

[👑] Card Title

[👑] Card Description

Birthday Message

In this area, you can setup and customize a birthday message to display on a users' birthday.

Send Message on Birthday

Here you may toggle whether a message is sent on a user's birthday.

Channel

This menu allows you to select the channel where the birthday message will be sent. If you don't see your channel, make sure to click on the refresh button next to the "Channel" text.

Message

Message Without Birth Year

Reactions

Here you may choose up to 5 custom reactions to be added to the message sent.

Create Thread

Here you may toggle whether a thread is created on the message for users to leave their birthday wishes in.

Lock Thread

Add Role on Birthday

In this area, you can setup and customize a function to add a role to the user on their birthday and remove it after 24 hours.

Add a Role on Birthday

Here you may toggle whether a role is added on a user's birthday for 24 hours.

Role

Here you may choose the role that is added to the user on their birthday for 24 hours. If you don't see your channel, make sure to click on the refresh button next to the "Channel" text.

/birthday showcase Command

In this area, you can setup and customize the functions of the /birthday command.

Enable /birthday showcase Command

Here you may enable and allow the usage of the /birthday showcase command.

Command Cooldown

This input allows you to set a cooldown for the command in minutes. Users won't be able to use this command twice wiithin this time range. It cannot be higher than 1440 minutes (24 hours).

Command Response

Commands Permissions

In this area, you can setup and customize the permissions for running each command.

Admin Roles

Channel Restrictions

You can setup channel restrictions to allow the usage of the module's commands only in certain channels.

Blacklist Type
Information

No channel restrictions

Users will be able to use the command everywhere.

Disable for these channels...

Set this blacklist type if you want the commands to work in all channels except the channels provided in the menu below.

Enable for these channels...

Set this blacklist type if you want the commands to work only in the channels provided in the menu below.

Role Restrictions

You can setup role restrictions to allow the usage of the module's commands only to certain roles.

Blacklist Type
Information

No role restrictions

Everyone will be able to use the commands of the module.

Disable for these channels...

Set this blacklist type if you want the commands to work for all users, except users with at least one of the roles provided in the menu below.

Enable for these channels...

Set this blacklist type if you want the commands to work only for users with at least one of the roles provided in the menu below.


Module Variables

The Birthdays module collects information about all users who record their birthdays. This information can be referenced using variables in the text settings of the module page, or in the builders. You can use any of these variables to provide accurate information in birthday messages, cards, etc.:

These variables can only be used in the Birthdays module.

Variable
Description

{target}

Returns an @mention for the target user

{target_id}

{target_name}

Returns the name for the target user.

{card}

[👑] Returns the image URL of the birthday card for the target user. Will return nothing if you have the Enable Custom Card setting disabled. Recommended for use in a plain text message or the image in an embed. This variable requires a premium subscription to work.

{age}

Returns the current age for the target user.

{birthday_timestamp}

Returns the UNIX timestamp of the birthday for the target user.

{day}

Returns the day of birth for the target user.

{month}

Returns the month of birth for the target user.

{year}

Returns the year of birth for the target user.

{current_year}

Returns the current year.


Commands

In this area, you can view and modify the commands of the Birthdays module. Below you may find some information on each command of the module.

/birthday set
/birthday remove

This command allows users to remove their birthday from the system. They can always add it back using /birthday set.

/birthday view

This command allows users to view their own or someone's else birthday. They can also update their personal settings by selecting themselves when running the command.

/birthday upcoming

This command allows users to get a list of all upcoming birthdays.

/birthday showcase
/birthday user-manage

Events

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

Birthdays Handler
Leaves Handler

This event automatically resets birthday data of users who left the server.


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.

Ensure that the "Default Server" option in your page is set to the server your birthday module runs in.

If you're still experiencing issues, join our to ask for further help, we'll do our best to solve your issue!

Here you may choose the timezone you'd like to set times in for this module. It is recommended that you select .

Features in this section are limited to users.

Here you may set the "title" text on the custom card. All can be used, as well as some additional variables that can be found .

Here you may set the "description" text on the custom card. All can be used, as well as some additional variables that can be found .

Here you may set the message that is sent on birthday. This message will be sent only if the user has set a birth year. All can be used, as well as some additional variables that can be found .

Here you may set the message that is sent on birthday. This message will be sent only if the user did not set a birth year. All can be used, as well as some additional variables that can be found .

Here you may toggle whether the thread created on the message is locked after 24 hours. The setting must be enabled. This setting is only visible with enabled.

This field allows you to setup the response the bot will return when the command is ran. All can be used, as well as some additional variables that can be found .

Here you may choose the roles who can use the command. They will be able to set, update, remove birthdays or blacklist users from adding their own birthday.

Returns the user ID for the target user. Can be used in other or to return the ID in general.

The birthday set command allows you to set your own birthday to a given date. The date must be provided in DD/MM/YYYY format. You can choose whether you want the birth year to be required in the setting. You cannot use this command if you're currently celebreating your birthday.

Users who are currently celebrating their birthday can use this command. You can configure it from the section.

This command can only be used by server's and allows them to update / edit certain information of the selected user. The list of available settings depends on the current birthday status of the user.

This event is the core of the module: it triggers every 30 minutes and ensures to wish your members a happy birthday. Make sure to not delete the associated timed event in the module.

support server
Timed Events
support server
your local timezone
List of all timezones
Timezones by country
Daylight saving time countries
timed events
default variables
here
default variables
here
default variables
here
default variables
here
create thread
Create Thread
default variables
here
/birthday-user-manage
Save Birth Year
/birthday showcase Command
admins
default variables
Birthdays module
Premium
Premium Subscription