Birthdays
Wish your members a Happy Birthday!
The Birthdays module allows users to set their birthdays, view users' birthdays, and receive automatically personalized birthday wishes.
Common Issues
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 support server to ask for further help.
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.
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.
Ensure that the "Default Server" option in your Timed Events page is set to the server your birthday module runs in.
If you're still experiencing issues, join our support server to ask for further help, we'll do our best to solve your issue!
Settings
General Settings
In this area, you can setup and customize the general settings for the commands and events of this module.
Timezone
Here you may choose the timezone you'd like to set times in for this module. It is recommended that you select your local 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.
Features in this section are limited to Premium users.
[👑] 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:
[👑] 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
Here you may set the "title" text on the custom card. All default variables can be used, as well as some additional variables that can be found here.
[👑] Card Description
Here you may set the "description" text on the custom card. All default variables can be used, as well as some additional variables that can be found here.
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
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 default variables can be used, as well as some additional variables that can be found here.
Message Without Birth Year
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 default variables can be used, as well as some additional variables that can be found here.
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
Here you may toggle whether the thread created on the message is locked after 24 hours. The create thread setting must be enabled. This setting is only visible with Create Thread enabled.
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
This field allows you to setup the response the bot will return when the command is ran. All default variables can be used, as well as some additional variables that can be found here.
Commands Permissions
In this area, you can setup and customize the permissions for running each command.
Admin Roles
Here you may choose the roles who can use the /birthday-user-manage command. They will be able to set, update, remove birthdays or blacklist users from adding their own birthday.
Channel Restrictions
You can setup channel restrictions to allow the usage of the module's commands only in certain channels.
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.
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.:
{target}
Returns an @mention for the target user
{target_id}
Returns the user ID for the target user. Can be used in other default variables or to return the ID in general.
{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
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 Save Birth Year setting. You cannot use this command if you're currently celebreating your birthday.
/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 user-manage
This command can only be used by server's admins 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.
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.
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.
Last updated
Was this helpful?