Commands

Birthdays

Set up birthday reminders, let members register their birthdays, and automate birthday announcements in your Discord server.

Commands Overview

Use /birthdays to manage birthday registrations and server-wide birthday announcements. Use /birthdays-config for admin configuration commands.

Command	Description
`register`	Register or update a birthday
`remove`	Remove a birthday registration
`show`	Show a user's registered birthday
`list`	List birthdays registered in the server
`upcoming`	Show birthdays coming up soon
`help`	Show birthdays command help
`birthdays-config`	Admin configuration commands for birthday announcements

Register

/birthdays register <day> <month> [year] [timezone]

Admins can also register a birthday for another user:

/birthdays register <day> <month> [year] [timezone] [user]

Parameters

day

integer required

Day of the month (1-31)

month

string required

Month from dropdown (January-December)

year

integer

Birth year (optional)

timezone

string

Valid IANA timezone (for example Pacific/Auckland) used for local birthday timing

user

Admin only - register or update a birthday for another member

Timezone Usage

Birthdays support per-user timezones so announcements and upcoming dates are calculated correctly.

Use a valid IANA timezone like Pacific/Auckland, Australia/Sydney, Europe/London, or America/New_York.
When registering, [timezone] is optional. If omitted, the server config timezone is used.
If neither a user timezone nor config timezone is set, the bot falls back to UTC.

Recommended flow:

Server admin sets a default timezone with /birthdays-config setup or /birthdays-config edit.
Members can optionally set their own timezone in /birthdays register if they want local midnight handling.

Remove

Remove your registered birthday:

/birthdays remove

Admins can remove a birthday for another user:

/birthdays remove [user]

Parameters

user

Admin only - remove another member's birthday

Show

Show a specific user's birthday (or your own if no user is provided):

/birthdays show [user]

Parameters

user

User to view a birthday for (defaults to yourself if omitted)

List

List all birthdays currently registered in this server:

/birthdays list

Upcoming

Show upcoming birthdays (next 30 days):

/birthdays upcoming

Help

Show the built-in birthdays help card:

/birthdays help

Birthdays-Config (Admin)

Admin commands for configuring birthday announcements:

Subcommand	Description
`details`	Show the current birthday config
`setup`	Create birthday config for this server
`edit`	Update birthday config values
`test`	Send a test birthday announcement

Birthdays-Config Details

Show the current birthday configuration:

/birthdays-config details

Birthdays-Config Setup

Create birthday configuration for this server:

/birthdays-config setup <announcement-channel> <overview-channel> [role] [timezone]

Parameters

announcement-channel

text-channel required

Channel where birthday announcements are posted

overview-channel

text-channel required

Channel used for the birthday overview/list message

role

Optional role to assign on birthdays

timezone

string

Default server timezone (IANA format, for example Pacific/Auckland)

Birthdays-Config Edit

Update one or more birthday config settings:

/birthdays-config edit [announcement-channel] [overview-channel] [role] [timezone] [enable]

Parameters

announcement-channel

text-channel

Update the announcement channel

overview-channel

text-channel

Update the overview channel

role

Update the birthday role

timezone

string

Update the default server timezone (IANA format)

enable

boolean

Enable or disable birthday notifications

Birthdays-Config Test

Send a test birthday announcement to the configured channel:

/birthdays-config test

Edit this pageorReport an issue

Games

Play games with your Discord community and have fun!

Utility

A collection of miscellaneous commands that don't fit into the other categories, but are still useful for managing your server and engaging with your community.