User Guide

Discord Tasks (Trello Power-Up) & Trello Tasks Bot (Discord)  ·  https://trellobot.hejapp.com

Contents

  1. Quick Start
  2. Commands
  3. How It Works
  4. Features
  5. Tips & Best Practices
  6. Plans & Limits
  7. Troubleshooting
  8. Privacy & Security
  9. Contact & Support

1. Quick Start

1
Connect your accounts Open the Power-Up settings panel. Connect Trello first, then Discord. Select your server and the channel where the bot should listen for commands.
2
Select a board and list In settings, choose the Trello board and list where new cards will be created.
3
Add the bot to your server The bot must be a member of your Discord server. If it isn't, an "Add Bot to Server" prompt will appear in settings.
4
Create your first task In the configured Discord channel, send a /task command. A Trello card and a dedicated thread are created immediately.

2. Commands

Create a Task
/task title:Title description:Description labels:#label attachment:file
/task title:Fix login bug description:Users can't sign in with Google labels:#bug attachment:screenshot.png

This creates a Trello card with the given title, optional description, optional labels, and an optional file attachment. The bot also opens a Discord thread linked to the card.

  • The description, labels, and attachment options are all optional
  • Labels (e.g. #bug) can be combined: #bug #urgent
  • Labels are created automatically on the board if they don't exist yet
  • Attached files (images, documents, etc.) are forwarded directly to the Trello card as an attachment
  • Only one file can be attached per /task command — additional files can be added to the card directly in Trello
Move a Card to a Different List
/move list:List Name
/move list:In Progress

Moves the linked Trello card to the specified list. The list name is case-insensitive. This command only works inside a task thread.

/move only works inside a task thread — it has no effect in the main channel.

3. How It Works

Creating Cards

When you send /task in your configured channel:

Adding Subtasks

Reply inside the task thread with your subtask text — each message becomes a separate checklist item on the Trello card. The bot reacts with 👍 to confirm the item was saved.

Write a test for the login flow
Check error logs on staging
Update the error message copy
Only plain text messages are processed. Slash commands such as /move are excluded, as are messages posted in the main channel.

Completing Subtasks

React with ✅ on a subtask message to mark the corresponding checklist item complete in Trello. Remove the reaction to mark it incomplete again.

Editing and Deleting Subtasks

Trello → Discord Sync

Every 30 seconds the bot checks Trello for changes and reflects them in the thread:

Edits made directly to checklist items in Trello — on items that were originally created from Discord — will not sync back to the Discord thread.

4. Features

Bidirectional Sync

Discord → Trello changes are applied instantly. Trello → Discord syncs every 30 seconds.

Smart Labels

Use #hashtags in your /task command's labels field. Labels are created on the board automatically if they do not exist yet.

Thread-Based Subtasks

Each task gets its own dedicated Discord thread, keeping subtask discussions separate from your main channel.

Reaction Controls

Mark subtasks complete or incomplete directly from Discord with a ✅ reaction — no need to open Trello.

List Management

Use /move inside a thread to move the card between Trello lists without leaving Discord.

Direct Card Links

Every task confirmation in Discord includes a direct link to the Trello card for quick access.

File Attachments

Attach a file or image directly in the /task command. It is forwarded to the Trello card as an attachment automatically.

5. Tips & Best Practices

Writing Effective Tasks

Organizing Subtasks

Team Collaboration

6. Plans & Limits

The current plan and usage figures are always shown in the Power-Up settings panel.

Plan Cards per month Active boards Price
Free 20 1 €0
Pro 200 5 €7 / month
Team Unlimited Unlimited €25 / month
Limits are per Trello account, not per Discord server. Connecting the same Trello account to multiple Discord servers does not multiply your quota — all boards and cards share a single allowance.
Only /task commands count toward the monthly card limit. Subtasks, edits, reactions, and /move commands are always unlimited.

Paid plans include a 14-day free trial and can be canceled at any time. Manage your plan via the Power-Up settings panel.

7. Troubleshooting

Bot not responding to /task

Card not being created

Subtask not appearing in Trello

Trello changes not reflected in Discord

If issues persist, open the Power-Up settings and verify that both accounts are connected and a board and list are selected. If the problem continues, contact support.

8. Privacy & Security

Deleting your data

See the full Privacy Policy and Terms of Service for details.

9. Contact & Support

Enjoying the Power-Up?

This tool is free to use. If it saves you time, a small contribution is always appreciated and helps keep the service running.

☕ Buy me a coffee