Built in 3 commands

Announcements: Features

Everything it does

Writing the post

The compose form is a small text editor with a preview that behaves like Discord.

Discord markdown, up to 2,000 characters. Bold, italic, headings, code blocks, quotes, links and mentions all render. The limit is Discord's own.
Up to 10 embeds. Paste one embed or a list of them as JSON in the Embeds field. An embed can carry an image by URL.
A live preview. The edit page draws the message as Discord will, with the bot tag, role names in their colours and timestamp tokens in every Discord format.
A private label. Name each announcement, up to 200 characters. The label shows in your calendar and history and never in Discord.
A real channel picker. Choose from your server's text and announcement channels, grouped by category. Only channels in this server are offered.

Scheduling

One-time or recurring, always in the time zone you set for that post.

Once, to the minute. Pick a date and a time in any time zone.
Daily, weekly or monthly. Weekly posts run on any set of weekdays. Monthly posts run on a day of the month or on the last day, and a day past the end of a short month moves to its last day.
A time zone for each post. New posts start in your server's time zone (UTC until one is set in Bot settings), and you can change it for any post. A recurring post fires in its own time zone, so 9 am on Monday means 9 am in the zone you chose. Any IANA zone name is accepted, and the form suggests the common ones.
Stop on its own. Give a series an end date, a maximum number of posts, or both.
Counters you can see. Each series shows how many times it has fired.

Managing the queue

Everything waiting to go out lives on one calendar, with the history underneath it.

A month calendar. Every upcoming post appears on its day, one-time posts in one colour and recurring posts in another, with every occurrence for the visible month expanded. Hover a day to see what fires, click a day to schedule something for it.
Pause and resume. A paused post skips its slot without being cancelled. Resuming a series moves its next run into the future so nothing fires late.
Fire now. Send a pending or failed announcement within the next check.
Edit until it fires. Pending and paused posts stay fully editable. Completed and cancelled posts are kept as history.
History by state. Pending, paused, recently completed, cancelled and failed each have their own list with the actions that fit.

Mentions

Pings are opt-in per post, and the setting is enforced in what is sent to Discord.

@everyone and @here stay off unless you turn them on. The switch is per announcement. It is applied in the message payload, not only in the form.
Role mentions on by default. Turn them off for a post when you only want the text.
Slash-command posts are always safe. /announce now suppresses everyone and here and has no switch to change that.

Delivery that repairs itself

The scheduler assumes channels get deleted, bots lose permissions and workers restart.

A check before every send. Before each post the bot confirms the channel still exists and it can still post there. A deleted or locked channel is flagged, the owner is told once a day, and the schedule is kept.
A second net after the send. If Discord rejects a post that the check could not predict, that exact announcement is flagged the same way.
Nothing lost to a restart. A post claimed by a worker that crashes mid-send is picked up again after about five minutes.
Missed slots fire once. If the bot was offline at the scheduled minute, the post goes out at the next check and the series continues from there.
No weekday ticked. A weekly series saved with no weekday ticked runs on Mondays.

In the dashboard

Scheduled Announcements The month calendar with previous, next and today, a legend, the pending count, and the pending, paused, completed, cancelled and failed lists with inline actions.
New Announcement Channel, time zone, one-time or recurring settings, end date and maximum posts, mention switches, embeds, and the live preview. Clicking a calendar day opens this form with that date filled in.
Edit Announcement The same form with the saved values, for anything still pending or paused. A post that failed because its channel was deleted or the bot lost access can be pointed at a working channel, and it re-arms itself.
Announcements Setup The one-click wizard that uses an existing #announcements, #announcement or #news channel as it is, or creates #announcements with read-only permissions for members and a short guide, pinned when the bot has the Pin Messages permission. Safe to run again.
Who can do what Viewers can open the calendar and lists. Managers can create, edit, pause, resume, cancel, fire and run setup. Each of those actions is written to the server's audit log.

Runs on its own

Checks every 30 seconds. The scheduler runs in the bot worker and claims up to 100 due posts per pass.
Sends through the normal action queue. The post goes out from whichever bot runs your server, the shared bot or your own.
Switched off, nothing lost. If Announcements is disabled at fire time, the post waits and goes out once the service is enabled again.
Marks your charts. When Analytics automatic markers are on, each announcement that fires becomes a labelled marker on your activity charts.

Limits

WhatValueNotes
Pending announcements per server100One-time and recurring posts still waiting to fire.
Message length2,000 charactersDiscord's limit for a message.
Embeds per announcement10Discord's limit.
Label length200 charactersDashboard only, never posted.
Recurrencedaily, weekly, monthlyWeekly on any weekdays. Monthly on a day of the month or the last day.
Scheduler passevery 30 sUp to 100 posts claimed per pass.

Safety

Managers only. Creating, editing, pausing, cancelling and firing need the manager role on the dashboard. Viewers can look.
Command locks. The slash commands are for the server owner, Administrators and members with Manage Server. On the Commands page you can allow a role or a member too, or limit where and how often a command runs.
The channel must be yours. The dashboard checks that the chosen channel belongs to this server before saving.
Mention settings are enforced. The everyone and here switch is applied in the message payload, so a form glitch cannot ping the whole server.
Setup asks for little. The wizard grants the bot only view, send, embed, read history, manage messages and add reactions in the channel it creates, trimmed to what the bot already holds.
No member data. The service stores the post, its schedule and the staff member who created it. Nothing about members.

What it does not do

  • No file or image uploads. An embed can reference an image by URL.
  • No buttons, menus or forms attached to a post.
  • No test send to a private channel. Fire now is a real send.
  • No yearly schedule and no every-N-days interval. The options are daily, weekly and monthly.
  • No templates library or bulk import. Each announcement is created on its own.
  • No per-member delivery, opt-in roles or read tracking. A post goes to a channel.
  • No cross-server broadcast. Each announcement belongs to one server.
Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord