Reminders
Let users set reminders for themselves - either via DMs or channels.
Reminders
Let users set reminders for themselves - either via DMs or Channels
This module is storing data in your bot's database.
This module has one configuration file.
This module is being actively used on over 4700 other servers on SCNX.
This module is included for free in every plan. Learn more about prices.
Features
- Users can set personal reminders with a custom message and duration.
- Reminders can be delivered either in the channel where the command was used or via DM.
- Snooze buttons allow users to postpone a reminder by 10 minutes, 30 minutes, 1 hour, or 1 day.
- Reminders survive bot restarts -- pending reminders are automatically rescheduled on startup.
- Supports flexible duration input (e.g., "2h30m", "1d", "45m").
Setup
- Make sure the bot has
View Channel,Send Messages, andEmbed Linkspermissions in the channels where reminders will be delivered. - Customize the reminder notification message in the module configuration.
Usage
Users can set a reminder using /remind-me:
- Specify when you want to be reminded using the
inparameter with a supported duration format (e.g., "2h", "30m", "1d12h"). - Provide the reminder message in the
whatparameter. - Optionally set
dmtotrueto receive the reminder via DM instead of in the current channel.
The reminder must be at least 1 minute in the future.
When the reminder triggers, the bot sends the configured notification message along with snooze buttons. Users can click these buttons to reschedule the reminder for an additional 10 minutes, 30 minutes, 1 hour, or 1 day.
Commands
Understand the documentation
In these docs,
name:<Type> is an option of a slash-command with name name and the type Type. Options that not required, are described as [name:<Type>]. If the action of a command is vastly different between required and not-required options, we might list them separately.Examples
/moderate ban user:<Member>: This command (/moderate ban) has an required option with the name "user" that only accepts one member as a value./moderate ban victim:<Member> reason:<Text>: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value and another required option with the name "reason" that accepts any text as an value./moderate ban victim:<Member> reason:<Text> [proof:<Attachment>]: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value, another required option with the name "reason" that accepts any text as an value and a not-required option with the name "proof" which allows one attachment as its value.
| Command | Description |
|---|---|
/remind-me in:<Text> what:<Text> [dm:<Boolean>] | Set a reminder. The in parameter accepts a duration format (e.g., "2h", "30m", "1d"). The what parameter is the reminder message. Set dm to true to receive the reminder via DM. |
Configuration
In this configuration file, you can configure the module. Open it in your dashboard.
| Field | Description |
|---|---|
| Reminder-Message | The notification message sent when a reminder triggers. Supports parameters for user mention, reminder message text, user tag, and user avatar URL. |
Troubleshooting
Reminders are not being delivered
- Make sure the bot has
View ChannelandSend Messagespermissions in the channel where the reminder was set. - If the reminder was set to DM, ensure the user has DMs enabled from server members.
- The reminder duration must be at least 1 minute in the future.
Stored data
The following data is being stored about every reminder:
- An auto-incrementing unique identifier
- The Discord User ID of the user who created the reminder
- The reminder text
- The channel ID where the reminder should be delivered (or "DM" for direct messages)
- The scheduled date and time for the reminder
- Metadata about the entry (date when created and last updated)
To remove all data stored by this module, purge the module database.
