Program timeline widget
The Program timeline widget is a Gantt-style view that lays out a Workspace's timeline on the dashboard. Its content adapts to the Workspace hierarchy: on a parent Workspace it rolls up the sub-Workspaces underneath; on a standalone or child Workspace it shows that Workspace's own timeline.
What it is
When added to a Workspace dashboard, the widget renders under the heading Timeline and shows one row per Workspace on a shared time axis. Each row has:
Workspace name — with a last-updated timestamp and a count badge of open items
Owner — the Workspace's accountable person
Date range — planned start → planned end
Progress — a bar with percent complete and a status indicator at the right edge
The widget is a single data source in the Add Widget panel — listed as Program Timeline. Its rendering adapts automatically:
On a parent Workspace (one that has sub-Workspaces under it in Managing), the widget shows one row per sub-Workspace — a portfolio view across your programs.
On a sub-Workspace or a standalone Workspace, the widget shows a single row for that Workspace's own plan.
You don't choose between "parent" and "child" variants yourself; the widget reads the hierarchy and renders the right shape.
Rollup variant on a parent Workspace:
Self variant on a sub-Workspace:
How it works
The timeline is generated from Workspace plan data — the AutoPlanner produces a timeline artifact as part of the plan update, and the widget renders that artifact on the dashboard. You don't maintain the timeline by hand; it updates each time the plan updates.
Changes from meetings flow through as usual: confirmed decisions can shift milestones, new commitments change the owned-by or date ranges, and progress numbers reflect the current state of the plan. Because the widget is generated, not drawn, there is no separate edit-the-Gantt workflow — you change what the timeline shows by changing the plan inputs (goals, activities, commitments) the way you normally would.
Adding the widget
Open the Workspace dashboard (the Workspace root page — not the Execution plan document).
Click the Dashboard options icon in the top-right of the dashboard.
Choose Add Widget from the menu.
In the Add Widget modal, open the Data source dropdown and select Program Timeline.
Optionally set a Widget Title (defaults to Timeline); pick an Appearance size.
Click Add Widget. The widget appears on the dashboard under the Timeline heading.
The same flow adds the widget to any Workspace, parent or child. The only thing that differs between placements is what the widget shows — not how you add it.
Reading the timeline
On a parent Workspace with sub-Workspaces, each row corresponds to one child. The row is a quick read of that program's status:
Bar color reflects health status — green for on track, amber for needs attention, red for at risk. The color is driven by the same health signal that surfaces on the rest of the plan; you don't set it directly.
The count badge next to the Workspace name (for example, 2 or 3) reflects open items on that program — a running heads-up on where attention is needed.
The last-updated stamp tells you when the sub-Workspace last ran a plan update.
For the rollup to make sense, sub-Workspaces should have a goal with a defined date range — that's what gives the row a start and end. Sub-Workspaces without any dated goal render without a bar.
If a parent Workspace has no sub-Workspaces at all, the widget shows an explicit empty state rather than a blank card — a hint that this is where child programs would appear once you create them.
Where it lives in the Workspace hierarchy
The widget is only useful if your Workspaces are structured as a parent program with sub-Workspaces underneath. If everything you manage is flat (no nesting), the widget will render a single-row "own timeline" on each Workspace and the rollup variant won't appear.
Setting up the parent/sub-Workspace relationship is a one-time admin change. It isn't currently self-serve — Customer Success assigns the parent and its sub-Workspaces for you. Once the hierarchy exists, the parent's left-nav entry expands to show its sub-Workspaces, and the parent's dashboard picks up the rollup variant automatically.
See Create a Workspace for the details on how parent/sub structure shows up in the Managing nav.
Related