# Reminders command reference

Create and manage scheduled reminders with notification destinations in Discord.

HTML reference: https://www.productivity-bot.com/docs/reminders/

A question mark after an option means it is optional.

## /reminder add

Create a reminder with a flexible schedule.

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

### Options

- `reminder` (Required): The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
- `schedule` (Required): Defines when the reminder should run. This can be a one-time schedule or a recurring schedule, depending on what the bot supports.
- `add_pings` (Optional): Optional Discord mentions to include when the reminder is sent.
- `description` (Optional): Optional extra details that explain the item more clearly than the short title alone.
- `expires` (Optional): An optional end date or time after which the recurring reminder should stop running.
- `destination` (Optional): 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.
- `visibility` (Optional): 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.

```text
/reminder list destination? sort? status? visibility?
```

### Options

- `destination` (Optional): 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.
- `sort` (Optional): Changes the order of the returned items, such as newest first, oldest first, due date, status, or other supported sorting modes.
- `status` (Optional): Filters by status or sets the current state of an item, depending on the command. For example: active, paused, completed, pending, or skipped.
- `visibility` (Optional): 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.

```text
/reminder show reminder visibility?
```

### Options

- `reminder` (Required): The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
- `visibility` (Optional): 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.

```text
/reminder edit reminder visibility?
```

### Options

- `reminder` (Required): The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
- `visibility` (Optional): 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.

```text
/reminder pause reminder until? visibility?
```

### Options

- `reminder` (Required): The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
- `until` (Optional): The date or time until which a reminder should stay paused.
- `visibility` (Optional): 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.

```text
/reminder resume reminder visibility?
```

### Options

- `reminder` (Required): The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
- `visibility` (Optional): 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.

```text
/reminder delete reminder visibility?
```

### Options

- `reminder` (Required): The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
- `visibility` (Optional): 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.