Milestones

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

They appear on both the Timeline and Calendar views, color-coded to your preference, and they move with you as you drag them to reschedule.

Where Milestones Appear

Milestones show up in the Timeline and Calendar views. They don't appear in Kanban or List views — those are flow-oriented, not date-oriented.

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

On the Calendar, each milestone renders as:

• A dashed pill inside the day cell where it falls (in month and week views)
• A list block at the top of the day in day view
• Color-coded to match the Timeline

Creating a Milestone

There are a few ways to add one:

How	Steps
Right-click the date header (Timeline)	Pick a date in the timeline's date ruler → Add milestone here
Right-click a day cell (Calendar)	Right-click anywhere in the day — empty space, day number, or milestone strip → Add milestone here. The date is pre-filled.
Toolbar button	Click Add milestone in the Timeline toolbar

All of these 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

Works the same on Timeline and Calendar.

• Click any milestone to open the edit dialog
• Right-click any milestone for a context menu with Edit and Delete

You can also drag a milestone to reschedule it — left or right along the Timeline, or to a different day cell on the Calendar. 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 the milestone → Delete (Timeline or Calendar). 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.