Birthdays
Announce member birthdays in a channel, give a temporary birthday role and customize the birthday message.
Overview
You can configure Cakey bot to announce birthdays for your users. All birthdays are restricted to the server you set them in. This means you must set your birthday manually in every server where you want it announced. Before anyone can use birthday commands, a server admin must enable the feature by selecting a birthday announcement channel.
Usage
Birthday announcement channel
The birthday announcement channel is where all of the birthday announcements are sent in your server. You MUST set a birthday channel before any of the birthday commands can be used. If you do not set an announcement channel, birthdays are not announced. You can set the birthday channel on the Bot Settings page of the web dashboard or with the /birthday channel <channel> command.
Note: Due to a Discord limitation you can't disable the birthday announcement channel with the /birthday channel command. Set it to "None" in the web dashboard instead.
Setting your birthday
Set your own birthday by running the /birthday set <month> <day> [year] [timezone] command. month is selected from a dropdown and day must be between 1 and 31. To change your birthday, run the command again with the updated date.
The command replies ephemerally with a confirmation, for example:
Successfully set @user's birthday to: Jan 5th
Server moderators can set/update another member's birthday by passing the optional user parameter.
The year parameter is optional. Leave it out if you don't want to share it. If provided, it must be between 1900 and 2100. The year is only shown back to you if you supplied one, for example Jan 5th, 1995.
Setting a personal timezone for your birthday
By default, Cakey Bot checks whether it's your birthday using the server's configured timezone (set on the Bot Settings page of the web dashboard). If you live in a different timezone than the rest of the server, your birthday can be announced a day early or late.
You can override this for your own birthday by passing the optional timezone parameter to /birthday set, using an IANA timezone identifier such as America/New_York, Europe/London, or Asia/Tokyo.
If you update your birthday date without passing timezone again, your previously-set timezone is kept. You don't need to supply it every time.
A server admin can also view and update (or clear back to the server default) a member's birthday timezone from the birthday page of the web dashboard.
View a user's birthday
View a single user's birthday with the /birthday view <user> command. This is not ephemeral, so everyone in the channel can see the response.
The response is formatted as, for example:
@user's birthday is Jan 5th
The year is appended (e.g. Jan 5th, 1995) only if that user provided one when setting their birthday.
If the user hasn't set a birthday, Cakey Bot replies ephemerally to let you know.
View upcoming birthdays
View upcoming birthdays with the /birthday next [limit] command. This is not ephemeral. By default it shows the next 5 birthdays, soonest first, and you can specify a limit between 1 and 10. Once the calendar rolls over into next year, birthdays wrap around and continue to be shown in order.
Only members still in your server are included. Each entry is formatted the same way as /birthday view, e.g. "@user's birthday is Jan 5th" (with the year appended only if provided).
List all birthdays
View every saved birthday in your server with the /birthday list command. Birthdays are grouped and paginated by month. Each page covers one month, and months with no birthdays are skipped entirely. Within a page, birthdays are ordered by day and formatted as, for example:
5th - @user
Only members still in your server are included, and each page's footer shows "Page X of Y".
You can navigate between pages using the bot's standard pagination buttons (◀️ ⏮️ ⏭️ ▶️ to move between pages, 🛑 to stop). The menu stays active for 5 minutes of inactivity.
If nobody in your server has a birthday saved, Cakey Bot replies ephemerally to let you know.
Remove your own birthday or another user's birthday
Remove your birthday by running the /birthday remove command.
You can remove another user's birthday by running /birthday remove <user>, but you must have Manage Server permission to do so.
Helpful Tip: You can also view and delete birthdays on the dashboard.
Birthday Role
Cakey Bot can also give users a temporary birthday role on the day of their birthday. The role is added when the announcement for their birthday is sent, and removed when the birthdays for the next day are checked. To set a birthday role, use the /birthday role <role> command or configure it on the birthday page of the web dashboard.
A birthday role is NOT required for birthday announcements. Announcements are sent whether or not a role is set.
Note: Due to a Discord limitation you can't disable the birthday auto role with the /birthday role command. Set it to "None" in the web dashboard instead.
Note: To prevent abuse, Cakey Bot does not let you select roles that contain any of these permissions:
AdministratorManage ServerManage Roles
If a role gains one of these permissions after being set, the bot stops assigning it.
Custom Birthday Message
By default, Cakey Bot announces birthdays with a generic message. You can customize this in the "Custom Birthday Messages" field on the birthday page of the web dashboard.
You can enter multiple messages separated by a semicolon (;). A random message from the list is chosen each time a birthday is announced.
You can also use these placeholders in your message(s):
{user.mention}: Mentions the user whose birthday it is.{user.username}/{user.nickname}/{user.globalname}: The user's username, nickname, or global display name.{server.name}: Your server's name.{age}: The age the user is turning. It stays empty for users who set their birthday without a year.
The custom birthday message is capped at 5,000 characters.
Related Commands
- /setup clear-all-birthdays Manage Server
Remove ALL birthdays for the server.
/setup clear-all-birthdays <confirm> - /setup clear-missing-birthdays Manage Server
Remove birthdays for users who have left the server.
/setup clear-missing-birthdays <confirm>