> ## Documentation Index
> Fetch the complete documentation index at: https://docsgetmyordo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> Send task notifications from Ordo to a Discord channel using incoming webhooks.

Ordo can post task activity to a Discord channel whenever events occur in a project. This uses Discord's incoming webhook feature — no bot or OAuth setup required.

## Create a Discord webhook

1. Open Discord and go to the channel you want notifications in.
2. Click the gear icon to open **Channel Settings**.
3. Go to **Integrations** then **Webhooks**.
4. Click **New Webhook**.
5. Give the webhook a name (e.g. "Ordo") and optionally set an avatar.
6. Click **Copy Webhook URL**. It will look like:

```
https://discord.com/api/webhooks/000000000000000000/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

> [!NOTE]
>
> URLs using `discordapp.com` are also accepted.

## Connect Discord in Ordo

1. Open **Settings** in the sidebar.
2. Under **Projects**, select the project you want to connect.
3. Open the **Integrations** tab.
4. Expand the **Discord** section.
5. Paste your webhook URL.
6. Optionally add a channel name label for your own reference.
7. Choose which events to subscribe to (see below).
8. Click **Connect**.

Once connected you can enable or disable the integration with the toggle, update event subscriptions, or disconnect entirely.

## Supported events

| Event | Default | Description |
| - | - | - |
| Task created | On | A new task is created in the project |
| Task status changed | On | A task moves to a different status column |
| Task priority changed | Off | A task's priority is changed |
| Task title changed | Off | A task's title is edited |
| Task description changed | Off | A task's description is edited |
| Task comment created | On | A new comment is added to a task |

You can toggle any combination of these events in the integration settings at any time.

## Message format

Ordo sends Discord embed messages with:

* A title describing the event (e.g. "Task Status Changed")
* Task name with a clickable link to the task in Ordo
* Fields for project, status, and priority
* The name of the user who triggered the event

Make sure [`Ordo_CLIENT_URL`](https://docsgetmyordo.mintlify.site/core/installation/environment-variables) is set to your public Ordo URL so task links work correctly.

## Updating the webhook

To change the webhook URL after connecting, paste the new URL in the webhook field and click **Save Changes**. If you leave the field empty, the existing URL is kept.

## Disconnecting

Click **Disconnect** to remove the integration. This deletes the stored webhook URL and all event settings for that project. You can reconnect at any time by pasting a new webhook URL.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.