Milestones

Milestones are named markers you place on the Timeline view to highlight important dates — release dates, deadlines, demos, checkpoints, or any moment your team needs to remember.

They appear as vertical dashed lines across the timeline, color-coded to your preference, and they move with you as you drag them to reschedule.

Where Milestones Appear

Milestones live on the Timeline view only. They don't show up in Kanban, List, or Calendar views — this is intentional, since milestones are a scheduling concept.

On the timeline, each milestone renders as:

• A vertical dashed line at the milestone's date
• In the milestone's color (or the board's primary color if none set)
• Labeled with the milestone's name, shown vertically along the line
• Above all tasks and bars in the stacking order, so it's always visible

Creating a Milestone

There are two ways to add one:

How	Steps
Right-click the date header	Pick a date in the timeline's date ruler → Add milestone here
Toolbar button	Click Add milestone in the Timeline toolbar

Both open the milestone dialog where you set:

Field	Description
Name	Required. 1-200 characters. Shown on the timeline.
Date	Required. Milestones are single-point markers — no date ranges.
Color	Optional. Defaults to the board's primary color.
Notes	Optional. Multi-line description, visible when you hover or right-click.

Click Save and the milestone appears immediately.

Permission

Only board Admins (and site Owners/Admins) can create, edit, or delete milestones. All board members can see them.

Editing a Milestone

Right-click any milestone line for a context menu:

• Edit — change name, color, date, or notes
• Delete — remove it permanently

You can also drag a milestone left or right along the timeline to reschedule it. The date snaps to day boundaries. This is the fastest way to push back a deadline without opening a dialog.

Deleting a Milestone

Right-click → Delete. Confirmation is immediate — milestones don't have an archive state, so this is permanent.

Tips

• One milestone per real-world event — use the name and notes for detail rather than splitting into multiple markers
• Use color to categorize: red for hard deadlines, green for releases, blue for internal checkpoints
• Milestones are board-scoped — every member sees the same set
• For milestones that span a range (a week-long launch window), create tasks with date ranges instead — milestones are meant for single-point markers
• Milestones outside the visible date range don't render — use the timeline's Fit button to see everything

Managing Milestones via MCP or API

If you use the MCP integration or REST API, milestones are available via:

• GET /v1/milestones — list milestones for a board
• POST /v1/milestones — create
• PATCH /v1/milestones/{id} — update
• DELETE /v1/milestones/{id} — remove

Writes require a Pro or higher token with write scope.