Getting started

Invite the bot, run your first command and create a list in a couple of minutes.

Team Tasks Manager (TTM) improves team coordination by letting you share and manage tasks without leaving Discord. If you have ever lost track of who was doing what across a chat and a separate task tool, this is for you.

This page takes you from zero to your first working list.

1. Invite the bot

Add to Discord

That button invites Team Tasks Manager to your server. During the invite, keep the permissions TTM asks for — it needs them to post lists, manage threads and run reminders. If you skip one, the bot will tell you exactly which permission is missing when it needs it.

The permissions TTM may use are:

Permission	Why it is needed
View channel	See the channel where the list lives
Send messages	Post and update the list
Embed links	Render the list as a rich embed
Manage messages	Clear the bot’s own older notifications, so the channel stays readable
Create public threads	Create the optional timeline thread
Manage webhooks	Write the timeline and run the webhook feature
Attach files	Provide the list download
Read message history	Keep the list in sync
Mention everyone	Notify the people you tag on a task, and the role that owns a task when its reminder comes due
Manage roles	Create the role that makes several people the owner of a task (Premium)
Use external emojis	Show the bot’s own icons on buttons and lists

Good to know

You can grant these later from Server Settings → Roles → Team Tasks Manager, or per channel from the channel's permission settings — except Manage roles, which works only on the bot's role, not per channel.

2. Run a slash command

TTM is built almost entirely on buttons, so there are only a few commands to remember. There are two ways to launch one:

Type / in the message box, pick Team Tasks Manager from the app list, then choose the command. After the first character Discord suggests your most-used commands at the top.

App Launcher — click the app launcher icon in the message bar, choose Team Tasks Manager under Apps on this Server, then pick the command.

Tip

If your server has many apps, type part of the command name to filter the list.

3. Create your first list

Run the command:

/create-list

TTM replies with a short legend on how to write a list and a Create your list button. Click it to open a form with two fields — the list title and the list of activities.

Already know the syntax?

The legend can be switched off in Configuration. With it off, /create-list opens the creation form immediately.

Type your activities one per line, each starting with a dash -:

- Design the landing page
  - Draft the copy
  - Pick the palette
- Set up the repository
- Ship to staging

TTM reads that text and builds the list for you. The rules are simple:

A new line that starts with - is a new task.
Spaces after the dash make it a subtask. No space → a task; one or more spaces → a subtask of the task above. A task with subtasks becomes a task group.
The title can be up to 256 characters.
The list can hold up to 4000 characters and up to 50 tasks in total (subtasks included) — 20 on the Free plan, see What Premium unlocks.

Once created, the list appears with a set of check controls and two rows of buttons. That panel is where the real power lives — head to The task list panel to master it.

Import a list from a file

Already have the list as a file? /create-list has a file option: attach a .txt made by the list’s Download (up to 64 KB), and TTM recreates the list in the channel — with its checked tasks, owners, tags, reminders and webhooks.

If something doesn’t fit, nothing is created, and one message lists every problem with its line or task: a file that isn’t in the Download format; roles, channels, members or webhooks that don’t exist in this server (when the file comes from another one); a reminder without an owner; a recurring reminder where recurring reminders aren’t allowed; the limits of your plan — tasks, repetitions, reminders waiting at the same time. Reminders already in the past are the exception: the list is created without them, and the bot tells you which ones it dropped.

A file that isn’t a .txt, or is larger than 64 KB, is refused straight away.

Next steps

Core concepts — tasks, subtasks, groups, owners, tags and states.
The task list panel — every button, explained.
Configuration — tailor notifications, time zone and more.