Overview

Welcome to the official Birthday Bot Documentation!

Example Announcements (Fully customizable):

Example Birthday Announcement

Example Custom Event

Example Member Anniversary Message

Example Server Anniversary Message

In your Discord server, Birthday Bot will track your users' birthdays and, using their time zone, celebrate their birthday through its customizable birthday role and message. Additionally, Birthday Bot can celebrate the anniversary of members joining the server and the anniversary of your server's creation!

If you haven't already, invite Birthday Bot to your discord here.

Free Features:

• Each user can set their birthday & time zone into the bot, which stores that information into a database, allowing the bot to know on what day and what time zone to celebrate the user's birthday

• Birthday System: Celebrate birthdays in your server!

  • By default, birthdays are shown in all servers with Birthday Bot, and birth years/ages are hidden. Users and server owners can customize this:

    • Users can use /user to edit their global settings and /user_server to edit their server-specific settings. User Privacy Settings.

  • Server owners can set up a custom birthday blacklist to prevent certain users and/or roles from having their birthday celebrated and shown in the server.

  • Server owners can set up the trusted role system in order to lock certain or all things related to the birthday system behind a specific role.

    • Customize if the trusted role prevents users from receiving the birthday role, birthday message, and/or appearing in the /next and /list command.

  • Server owners can disable all ages in their server with the disable ages setting.

  • The birthday channel is the channel where the bot will post birthday messages and you can customize:

    • Up to 3 unique birthday messages. Learn more about custom messages.

    • The time of day the birthday messages are posted.

    • Whether birthdays are celebrated based on the user's time zone or the server's time zone using the use time zone setting.

    • A custom ping setting for all birthday messages.

  • The birthday role is the role that will be given to users on their birthday and taken from those whose birthday it isn't.

• Custom Event System - Create a custom event that will be celebrated in your server.

  • Each custom event has a date, time, with an optional year. If given a year, the event will only happen once on that year, otherwise, it will repeat yearly.

  • Each event has a custom message associated with it.

  • Each has it's own ping setting.

• Anniversary System - Celebrate member and server anniversaries in your server!

  • Requires the server time zone to be set

  • Customize:

    • Up to 3 unique member anniversary messages Learn more about custom messages.

    • Up to 1 unique server anniversary message Learn more about custom messages.

    • The time of day the anniversary messages are posted.

    • A custom ping setting for all anniversary messages.

• Configure many more settings such as:

  • Name format settings which decide how the bot displays names in custom messages, the /list command, and everywhere else!

  • How dates are detected in your server with the date format setting.

• View upcoming birthdays/anniversaries.

• Clear your information from the database at any time.

• Near 24/7 up-time!

Premium Features:

• Avoid having to vote to use some commands.

• Priority message posting.

• Custom Event System: Create up to 500 custom events that will be celebrated in your server!

  • Each custom event has a date, time, and optional year. If given a year, the event will only happen once on that year otherwise, it will repeat annually.

  • Each event has a custom message associated with it.

  • Each has it's own ping setting.

• Setup member anniversary roles to celebrate how long members have been in your discord

  • For example, the 3-Year Veteran role can be set to be given on a member's 3 year anniversary in your discord.

• Setup Multiple trusted roles

  • Use the RequireAllTrustedRoles setting to decide if users need all trusted roles or just one to have their birthday celebrated.

• Set the trusted prevents ping setting to decide if the trusted role prevents users from receiving the birthday ping.

• More control over the Custom Message(s).

  • Up to 500 custom birthday messages (vs 3 for free).

  • Up to 500 custom member anniversary messages (vs 3 for free).

  • Up to 500 custom server anniversary messages (vs 1 for free).

  • Fully customize embedded custom messages.

    • Custom color, image, title and footer. The message must be embedded for these settings to work.

  • Set user-specific custom messages for both birthdays and member anniversaries.

    • One custom message per user

    • Unlimited user-specific messages per server

  • Custom post modes for all celebration types! (Threads & Pins!)

• Permanent Lists

  • Generates a list like the /list command, but the list is permanent and updated hourly by the bot.

  • Available for both birthdays and member anniversaries.

• Even more settings:

  • Filter your custom birthday messages by what placeholders they have.

• Support Development!

  • Since I started Birthday Bot, I have maintained development and server costs completely out of my own pocket. Birthday Bot Premium allows me to continue to maintain development as Birthday Bot continues to gain tens of thousands of servers each month.

  • Subscriptions to Birthday Bot Premium go straight to server costs.

Support and Troubleshooting

Birthday Bot is a part of the Arilyn Bot family, and any support, questions, or feedback are welcome in our support Discord. Please visit our FAQ and setup guide, as well as previous user questions, before contacting staff. Thanks!