Todo lists — command reference

Shared task boards for your server. Lists live in a channel; boards update in place when tasks change. Configure lists in the Feature Centre → Todo Lists dashboard panel, or entirely from Discord.

Requires: Todo Lists enabled in Feature Centre · /todo and /todo-admin enabled on the Commands tab

Concepts

Term	Meaning
List	A named todo board tied to a channel (default list name = that channel)
Item	A single task with an ID (shown on the board and in `/todo add` replies)
Board	The live embed message(s) showing open tasks — refreshed when you run `/todo board` or when tasks change
Log channel	Optional guild-wide channel where all list boards are mirrored (`/todo-admin set-channel`)

Run /todo help in Discord for a quick in-bot reference.

`/todo`

`/todo help`

Shows examples and available options (ephemeral embed).

`/todo add`

Add one task or up to 10 tasks at once.

Parameter	Required	Description
`title`	One of `title` or `tasks`	Single task title
`tasks`	One of `title` or `tasks`	Multiple tasks — separated by comma, semicolon, or newline (max 10, duplicates ignored)
`description`	No	Extra details (single-task only; ignored when using `tasks`)
`name`	No	List name (autocomplete). Default: list for this channel
`assign_user`	No	Assign to a user — they can be DM'd reminders
`assign_role`	No	Assign to a role — any member with that role can complete; no DMs
`due_in`	No	Due date as minutes from now (e.g. `120` = 2 hours)
`remind_in`	No	Send a reminder minutes from now

Rules

You cannot set both assign_user and assign_role.
Assignees get a channel mention when tasks are added (if the bot can post there).
The board syncs automatically after adding.

Examples

/todo add title:Write patch notes due_in:1440 assign_user:@ModName
/todo add tasks:Fix bug, Update docs, Post announcement name:Release
/todo add title:Weekly review description:Check mod logs and open tickets

`/todo board`

Refresh the todo board embed in the current channel (and mirror to the log channel if configured).

Parameter	Required	Description
`name`	No	List name (autocomplete). Default: this channel's list
`hide_done`	No	`true` = hide completed items (default shows completed)
`page`	No	Page number, starting at 1 (for long lists)

Notes

First run in a channel creates the board message if it doesn't exist.
If a log channel is set, boards stay mirrored there after task changes.

Examples

/todo board
/todo board name:Staff hide_done:true
/todo board page:2

`/todo status`

Change a task's status. Item IDs appear on board embeds and in add confirmations.

Parameter	Required	Description
`id`	Yes	Todo item ID (integer ≥ 1)
`state`	Yes	`todo` · `doing` · `done`

Who can update

Item creator
Assignee (user or member of assigned role)

Marking done cancels pending reminders.

Examples

/todo status id:42 state:done
/todo status id:15 state:doing

`/todo update`

Change assignee, due date, or reminders. Only the item creator or server owner can run this.

Parameter	Required	Description
`id`	Yes	Todo item ID
`assign_user`	No	Reassign to a user
`assign_role`	No	Reassign to a role
`due_in`	No	New due date (minutes from now)
`remind_in`	No	Schedule a new reminder (minutes from now)
`clear`	No	Remove a field: `assignee` · `due` · `remind`

Rules

Cannot set both assign_user and assign_role.
Provide at least one of: assignee, due_in, remind_in, or clear.
Reassigning notifies the new assignee in channel.

Examples

/todo update id:42 assign_user:@NewOwner due_in:480
/todo update id:42 clear:due
/todo update id:42 clear:assignee remind_in:60

`/todo-admin`

Requires Manage Server Discord permission.

`/todo-admin list`

Create or look up a named list in the current channel.

Parameter	Required	Description
`name`	Yes	List name (autocomplete; supports `id:123` to look up by ID)
`create`	No	Create if missing (default true)

Examples

/todo-admin list name:Staff
/todo-admin list name:Events create:false

`/todo-admin set-channel`

Set a guild-wide todo log channel. Posts one mirrored board message per list (does not remove home-channel boards).

Parameter	Required	Description
`channel`	Yes	Text or announcement channel for mirrored boards

`/todo-admin clear-channel`

Clears the log channel setting. Existing mirrored messages are not deleted.

`/todo-admin show-channel`

Shows the currently configured log channel, if any.

Permissions & access

Enable Todo Lists in Feature Centre
Enable /todo and /todo-admin on the Commands tab
Grant command access under Settings → Permissions for staff who should manage lists

/todo-admin additionally requires Discord Manage Server.

Tips

Use named lists (name:) when one channel hosts multiple boards (e.g. Staff, Events)
Set a log channel so leadership can see all lists in one place
Use due_in and remind_in for event prep and recurring chores
Manage larger lists from the dashboard Todo panel for bulk edits

Features overview — Todo lists · Commands summary

Custom bot Moderation commands