Create custom events

On this page

Custom events are a Premium feature for scheduled announcements, such as a yearly server party or a one-time meetup. Each event has its own date, post time, ping, and message.

Open your server dashboard

On the website

Choose your server and open Custom events.
Under Announcement, choose a Channel and Post mode, then press Save changes. These settings apply to every custom event.
Press + New event and enter a Name.
Under Date, choose the month and day, then Every year to repeat the event or a single year to run it once.
Set Post time and Ping for this event. Post time follows the server's time zone, which you can change in Server settings. The ping is posted in the announcement, at the bottom of a card or above plain text, and counts toward its length. If the Post mode under Announcement is Threads, you can also give the event its own Thread name (see How is the event's thread named?).
Under Message, choose Plain text or Embed and write the announcement. Plain text has about half the room of an embed, so a long announcement may need Embed; the editor tells you when the message is too long to post. See Customize your messages for styling and who the message notifies, and Placeholders for details you can insert.
Check the preview beside the editor, or press Full screen to see it at full size on a desktop and a phone side by side. On a phone, switch to the Preview tab to see it, then back to Edit.
Press Create event. To change an existing event, open it from Custom events, edit it, and press Save changes. The ← Custom events link (and Cancel on a new event) asks before throwing away unsaved changes.

You can save up to 500 custom events.

What success looks like

Your event appears on Custom events. When its date and post hour arrive, Birthday Bot sends its message to the shared event channel. For example:

# events

Birthday BotAPPToday at 9:00 AM

🎮 It's game night! Join us in voice when you're ready.

How is the event's thread named?

When the Post mode under Announcement on Custom events is Threads, Birthday Bot opens a thread under each event announcement. Otherwise the event's Thread name field shows Threads off, with a Change post mode link back to Custom events.

Leave Thread name empty to name the thread after the event, exactly as its name is written. A name of your own can use the year placeholder (the year the event is celebrated) and the date placeholder (the event's month and day): click one shown with the field to insert it, and the example under the field shows how the thread would be named. A thread name can be up to 100 characters. Birthday Bot refuses to save a thread name with a placeholder events never fill in, such as the one for members' names. Placeholders lists the ones you can use.

What happens after a one-time event?

An event set to a single year does not repeat next year. Once its date is past, it is hidden from the usual list rather than deleted. Turn on Show past one-off events to find it again, then open it to edit or delete it.

Common problems

I cannot save an event, or my events stopped posting. Custom events need active Premium on this server. Check Premium activation.
The event was posted at the wrong hour. Its own Post time uses the server's time zone. See A message was posted at the wrong time.
The message or ping did not work. Check the warnings beside Channel, Post mode, or Ping, then follow Missing permissions.
An older event disappeared from the list. Turn on Show past one-off events to see events whose one-time date has passed.

Using Discord instead

Use the event commands to create, edit, view, test, or remove an event:

/event

PremiumManage Server

Configure a custom event.

/event edit date

3 options

Edit the date of a custom event.

name required · text: The name of the event you are editing.
date required · text: What should the date of the event be? Month and day only.
year optional · whole number · 2023 to 2500: If you give a year, the event will only trigger on that year. Leave blank to trigger every year.

/event edit name

2 options

Edit the name of a custom event.

name required · text: The name of the event you are editing.
new_name required · text: What should this custom event be called?

/event edit ping

2 options

Edit the ping setting of a custom event.

name required · text: The name of the event you are editing.
ping optional · text: Who should the bot ping when sending this event's message? Leave blank for no ping.

/event edit hour

2 options

Edit the hour of a custom event.

name required · text: The name of the event you are editing.
hour required · whole number · 0 to 23: What time should the bot send this event's message? (0 = midnight, 23 = 11:00 PM)

/event edit thread_name

2 options

Edit the thread name of a custom event.

name required · text: The name of the event you are editing.
thread_name optional · text: This event's thread name. Placeholders like {Year} work. Leave blank to use the event's name.

/event add

6 options

Add a custom event.

name required · text: What should this event be called?
date required · text: What should the date of the event be? Month and day only.
year optional · whole number · 2023 to 2500: If you give a year, the event will only trigger on that year. Leave blank to trigger every year.
image optional · file: An image for the event's custom message. Only works if the message is embedded.
ping optional · text: Who should the bot ping when sending this event's message? Leave blank for no ping.
hour optional · whole number · 0 to 23: What time should the bot send this event's message? (0 = midnight, 23 = 11:00 PM)

/event remove

1 option

Remove a custom event.

name required · text: The name of the event you are removing.

/event test

1 option

Test a custom event.

name required · text: The name of the event you are testing.

/event view

1 option

View a custom event.

name required · text: The name of the event you are viewing.

Removing an event also removes its message. An event's message can't be removed on its own, because the event needs it to post.