The task list panel

Every button under your list, what it does, and how the three-state task buttons work.

Once a list exists, TTM shows a check selector and two rows of buttons beneath it. This panel is the heart of the app: almost nothing here needs a command, you just click.

Under the list

The list ends with a thin progress bar: the share of ticked boxes, tasks and subtasks alike, in steps of 5%. It moves as soon as one box is ticked, and it is full only when every box is. A sealed list keeps it, showing where the list ended.

Above the bar, a small line helps whoever is new: Not sure what the buttons do? More → Guide. Guide, in More, explains every button without leaving Discord. If your team doesn’t need it, hide the Tips in Configuration: the line goes, the bar stays. While the list is locked, the same line says who is editing it and how to unlock it, even with the Tips hidden: see When the list is locked.

The check selector

Above the buttons sits the check selector: the drop-down menu that shows the list’s title. A list with more than 25 tasks has two menus, each labelled with the position of its last task. Use it to:

Mark tasks done or open — tick a task to complete it, untick it to reopen it. Its checkbox shows or .
Pick the task that an active button acts on (see Row 2).

Ticking or unticking a group does the same to its subtasks. Completing all its subtasks completes the group.

Only the owner can tick or untick a task that has an owner. These people can do it:

the owner, or the members of the owner role;
whoever has Manage messages on the channel.

Anyone else gets a refusal that only they can see, and nothing changes. The rule covers subtasks too: you can’t tick or untick a group if that changes a subtask that belongs to someone else. Anyone who can use the list can tick a task without an owner.

Keep the task buttons off

To tick or untick tasks, every button in the second row must be off. If any task button is active (blue or red), picking a task applies that action instead of ticking it.

Row 1 — acts on the whole list

These buttons never touch a single task: they act on the entire list.

Button	Function	What it does
	Clone list	Clone the list into another channel. It opens a channel picker and a few options (see Clone options).
	Bulk update	Edit the title and the whole list in one form: the fastest way to change two or more tasks. While you edit, the list is locked.
	Clean list	Remove every completed task, after a confirmation.
	Reopen all	Bring every completed task back to to-do. You can also move their reminders to a new date.
	More	Open a panel with the actions you need less often: the in-Discord guide, and download, seal or delete the list. When the list is locked, you unlock it here.

Clean list

Clean list removes every completed task, subtasks included, and renumbers the tasks that stay. A group that isn’t completed stays, even when some of its subtasks go.

First, a confirmation window tells you how many tasks will go, and what goes with them. They go for good, with their reminders and tags, if they have any. If your server’s configuration allows it, the notification in the list’s channel or in its thread shows the removed tasks: see Notification mode. Submit to confirm, or close the window to cancel.

No task completed: there is nothing to remove, and the bot says so at once.
Every task completed: Clean refuses, because a list can’t be empty. Untick at least one task, or remove the whole list with Delete list in More.

Reopen all

Reopen all brings every completed task back to to-do, on the same message. Text, owners, tags and reminders stay as they are. If no task is completed, the bot says there is nothing to reopen.

First, the bot asks you in a message that only you can see:

Reopen — reopen every task now.
New date — reopen, and move the reminders of the tasks you reopen. The When window opens: the first of those reminders in the calendar moves to the date you pick, at least 5 minutes from now. The others keep the same distance from it. Reminders of tasks still to do stay as they are. This choice appears only when a task you reopen has a reminder.
Cancel — leave the list as it is.

Reopening calls no webhook, and it ignores owners: anyone who can edit the list can reopen it.

If someone locks or seals the list before you confirm, nothing changes: see When the list is locked.

What’s inside More

Discord allows five buttons per row, so the actions you need less often sit in a panel that only you can see:

Unlock list — only while the list is locked. It shows who is editing, and turns the list’s buttons back on for everyone. See When the list is locked.
Guide — the quick in-Discord guide, with a link back to this documentation.
Download — a .txt file of the list, written as in the Bulk update form and sent only to you. Keep it as a backup, or rebuild the list from it with /create-list, even on another server: see Reuse a list anywhere.
Seal list — keeps a finished list in the channel as a record, marked Sealed list, without buttons or menus. Its reminders stop, and it frees a place on your plan. What stays and what goes: Seal.
Delete list — deletes the list permanently, with its tasks, owners, tags and reminders. The message is removed, and a short receipt takes its place in the channel.

Sealing and deleting can’t be undone, and the bot asks you to confirm first. Both need Manage messages on the channel: the same permission that lets you delete the list’s message by hand. Without it, those two entries aren’t there. Guide and Download are there for everyone, and so is Unlock list when the list is locked.

While the list is locked, Seal list and Delete list aren’t there. Whoever is editing would save onto a list that no longer exists.

Why delete instead of removing the message?

If you delete the message by hand, the list's data stays, and its reminders keep arriving. Delete list takes the reminders with it. If a message is already gone, /config lists lets you clean up, or bring the list back.

Clone options

When you start Clone list, the cloning controls replace the first row:

Create list — start cloning into the channel you picked in the dropdown.
Selection option — keep the ticks in the clone, or not.
Reminder option — keep the reminders in the clone, or not.
Exit — go back to the list panel as it was. If someone was editing the list, it stays locked.

The dropdown offers text channels and voice channels. A clone in a voice channel has no activity timeline: see Voice channels.

A clone gets new reminders, so a recurring reminder can be refused: see Repeating reminders.

A clone is a new list, so it follows your plan like any other. It needs a free place, and it can’t have more tasks than your plan allows. On the Free plan, a list with more than twenty tasks can’t be cloned: see What Premium unlocks.

Row 2 — acts on a single task

Each button in the second row is a three-state switch. Click it to cycle through the same colors Discord uses for its buttons:

Grey — off.
Blue — active in edit mode.
Red — active in delete mode.

The workflow is always the same: turn a button blue or red, then pick the task in the check selector. TTM applies the action to that task. While a button is blue or red, the selector says what will happen, for example Edit task or Delete task; with every button off, it says Tick a task: pick a task there to tick or untick it.

Function	Blue (edit)	Red (delete)
Content	Change the task text (opens a form). Line breaks become spaces. Owners, reminders and webhooks typed there are removed, and the bot tells you what it removed: they have their own buttons. A text left empty, one with a reminder in months, or one that would make the list too long isn’t saved.	Delete the task. Deleting a group with subtasks asks you first. Its subtasks stay in place: they join the group above, or become tasks if there is none. You can’t delete the last task: use Delete list or Seal list in More.
Owner	Set or change the owner: one person, one role, or several people (see Owner).	Remove the owner, and its reminder too: nobody is left to receive it. If the reminder hasn’t fired yet, TTM asks you to confirm first.
Tag	Set the users and roles to notify. You can pick several at once (see Two ways to tag).	Remove every tag on the task.
Reminder	Add or edit a reminder: start date and time zone. Interval and repetitions come with recurring reminders, a Premium feature switched on in Configuration.	Remove the reminder.
Webhook	Link a webhook: completing or reopening the task then fires an HTTP call (see Webhooks).	Remove the webhook from the task.

Confirming a tag selection — desktop vs mobile

The Tag and Owner menus let you pick several at once. These multi-select menus don’t apply a choice as soon as you tick it: they wait for you to confirm the whole selection. Single-choice menus, like the check selector, apply as soon as you pick. How you confirm depends on the device:

On mobile, a Save button appears under the open menu. Tap it to apply your picks.
On desktop, there is no Save button. Click anywhere outside the menu to close it: closing the menu applies your selection. If your tags don’t seem to apply, this is almost always the reason.

This matters most in live editing of tags or owner: on desktop, each click outside the menu saves one change.

Owners and tags

Owner and Tag have their own page: Owners and tags, with the owner menu, the two ways to tag and the roles TTM creates. How Tag behaves depends on Behavior on selection in /config app:

In one line

With Reset status after selection (the default), tagging always overwrites, and you must pick people first. With Keep status after selection, pick people first to overwrite (assign), or pick the task first to edit its tags live.

When the list is locked

TTM locks the list while someone edits it:

in Bulk update;
in the form of a task’s text;
in a reminder form.

For everyone else, these turn off: the check selector, Bulk update, Clean list, Reopen all and the task buttons. Clone list and More stay on. More shows who is editing, and a locked list can’t be sealed or deleted from there.

The last line of the list says it too: 🔒 @name is editing this list. Stuck? More → Unlock list. It takes the place of the Tips line, and it shows even when your server hides the Tips. The mention shows the name and doesn’t notify anyone. When the list is unlocked, the Tips line comes back, if your server shows it.

Locking the list also turns Owner, Tag and Webhook off if one of them was on: open it again from its button when you need it.

Saving the form unlocks the list. Closing it with Cancel or the ✕ doesn’t, because Discord doesn’t tell the bot: Bulk update and the form of a task’s text say so in their last line. Then anyone can unlock the list: open More and press Unlock list.

An admin can still seal, delete or regenerate a locked list from /config lists. If that happens while you are editing, your change isn’t saved. The bot tells you, and gives you back the text you wrote.

When the list changes while you edit it

Someone may have started an action before you locked the list: a reminder, or a task’s text. When they finish, their change applies, but the list stays locked for you. More then says who updated it in the meantime.

When you save Bulk update, TTM checks whether the list is still the one you opened. If it changed, nothing is saved yet. A message only you can see says so, shows the text you wrote, and offers three choices:

Overwrite — save your text. The updates made in the meantime are lost.
Reload — reopen Bulk update with the updated list. Your text stays in the message, to copy from.
Cancel — keep the list as it is, with the updates, and unlock it.

If the list gets locked or sealed before you confirm Clean or Reopen, nothing changes. The bot tells you: This list can’t be changed right now.

When a bulk update can’t be saved

The list title can be up to 90 characters. If the bot can’t read your text as a list, it shows the text back, with an arrow on each wrong line. The arrow marks a line without a dash, a first line that is a subtask, or a line with a reminder in months (M). It also marks a reminder written badly: two dates or two triplets, a date without its triplet, or a reminder without task text. A webhook token ({{wb=…}}) without task text gets the arrow too. Otherwise, one message lists every problem at once, one per paragraph:

the list is too long;
the list has more tasks than a list can hold, or than your plan allows;
a reminder is over a limit: recurring where recurring reminders aren’t allowed, repetitions over your plan, or too many reminders waiting at the same time;
a reminder has no owner, or no date and a distance of zero.

Fix them all and submit again.

A reminder whose alerts are all in the past doesn’t stop the save: it stays on its task. See Reading a reminder on the task.

Where to go next

Owners and tags — the owner menu, the two ways to tag, and the roles TTM creates.
Reminders — the full reminder form, explained field by field.
Personalize your lists — write mentions, channel links and hyperlinks by hand, in Bulk update and in task edits.
Configuration — control notifications, history and permissions.
Something not working? — quick answers to the most common problems.