Skip to content

Reminders command reference

Create and manage scheduled reminders with notification destinations in Discord.

A question mark after an option means it is optional.

Read as Markdown

/reminder add

Create a reminder with a flexible schedule.

Usage

/reminder add reminder schedule add_pings? description? expires? destination? visibility?

Options

reminderRequired
The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
scheduleRequired
Defines when the reminder should run. This can be a one-time schedule or a recurring schedule, depending on what the bot supports.
add_pingsOptional
Optional Discord mentions to include when the reminder is sent.
descriptionOptional
Optional extra details that explain the item more clearly than the short title alone.
expiresOptional
An optional end date or time after which the recurring reminder should stop running.
destinationOptional
Where reminder or habit notifications are delivered, such as your DMs or a server channel. When listing reminders, selects which destination to show. This is separate from visibility, which controls who sees the command response.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/reminder list

List reminders by destination and status, with optional sorting.

Usage

/reminder list destination? sort? status? visibility?

Options

destinationOptional
Where reminder or habit notifications are delivered, such as your DMs or a server channel. When listing reminders, selects which destination to show. This is separate from visibility, which controls who sees the command response.
sortOptional
Changes the order of the returned items, such as newest first, oldest first, due date, status, or other supported sorting modes.
statusOptional
Filters by status or sets the current state of an item, depending on the command. For example: active, paused, completed, pending, or skipped.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/reminder show

View details for a reminder.

Usage

/reminder show reminder visibility?

Options

reminderRequired
The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/reminder edit

Edit a reminder.

Usage

/reminder edit reminder visibility?

Options

reminderRequired
The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/reminder pause

Pause a reminder temporarily.

Usage

/reminder pause reminder until? visibility?

Options

reminderRequired
The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
untilOptional
The date or time until which a reminder should stay paused.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/reminder resume

Resume a paused reminder.

Usage

/reminder resume reminder visibility?

Options

reminderRequired
The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/reminder delete

Remove a reminder.

Usage

/reminder delete reminder visibility?

Options

reminderRequired
The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.