The table is the left half of the chart: one row per initiative, milestone, workstream and item, with the same hierarchy as the bars. It is also an editor, and it works like the Items Table: the same cells, the same arrow-key movement, start typing to edit, the same right-click menu and the same bulk edit. Every change is written to the real item, exactly as if you had edited it in the item workspace or the Items Table, and an edit made elsewhere, such as in the item drawer, shows here without a reload.
Drag the divider between table and timeline to resize the table (Drag to resize sidebar), or click the chevron to collapse it (Click to collapse) and get the bars full width. Click to expand brings it back.
These columns show by default:
| Column | Shows | Editable for |
|---|---|---|
| Name | The same label as the Items Table: item type icon, optional item number, title, then the archived, imported, overdue, blocked and bug markers and the work-type chip. A red title means overdue; the overdue marker's tooltip gives the date, for example Overdue (Oct 20). | Opens the item (initiatives and milestones: their edit dialog). Not available on locked rows. |
| Start date | The item's start date, written as in the Items Table: Today, Tomorrow, a weekday within the coming week, or a date such as Oct 27 (with the year when it is not this year). Milestones show -. Initiatives show the earliest date inside them. | Workstreams and items |
| Due date | The item's due date, written the same way and red when overdue. Milestones show their date. Initiatives show the latest date inside them. | Workstreams, items, milestones |
| Duration | Start to due, humanized (for example 9 days). | Workstreams and items |
| Cycle / Board | The item's board, with a cycle icon for time-based boards and a column icon for perpetual ones. Unplanned when unassigned. Restricted, with a lock, when you cannot view the board. Other rows show -. | Work items |
| Progress | Percent complete, by the attribute chosen in Options → Show Bar Progress By (counted from the lowest-level work when Progress from Lowest-Level Work is on), as a number centred over a fill that grows from the left: red at 0%, yellow at 50%, green at 100%. A small pencil marks a percentage set by hand. Hidden when progress is set to Hide progress. | Workstreams and items |
| Relationships | Linked item numbers, colored by type: orange for items this one depends on, blue for items it blocks, green for related. Milestones show their names. Click a number to preview that item. | Workstreams and items |
Every other column starts hidden; add it from Table columns (see Choose columns). Each one is the Items Table's own cell, so it looks and edits exactly as it does there.
| Column | Editable |
|---|---|
| Assignee, Status, Priority, Tags, Team | Yes |
| Parent, Item Type | Yes |
| Time Spent, Point Estimate, Time Estimate | Yes |
| Watchers, Blocked Reason | Yes |
| Creator, Date Added | Only with the Backdate Item History permission (see Correcting an item's real history) |
| Subtasks, Completion Date, Children Point Effort, Children Time Estimate, Children Time Spent | No, display only |
| One column per custom field | Yes, where the field applies to the row's work type; calculated fields never |
These columns hold work-item fields, so they are editable on work-item rows only; workstream, initiative and milestone rows show a dash. The custom-field columns are the fields of the work types on this chart, named after the field and listed after the built-in columns. Point Estimate and Children Point Effort appear only when your organization uses point estimates, and Time Estimate and Children Time Estimate only when it uses time estimates.
Three more columns appear while a scenario is active. See Scenario Planning.
While a scenario is recording, Progress, Cycle / Board, Relationships, every Items Table column you can edit and every custom-field column are read-only, because those edits would change the real items: Read-only while a scenario is recording. Only date moves are recorded.
Initiative cells that are not editable explain why in a tooltip: Initiative dates are inferred from the workstreams and items they contain. These dates are not editable. Rows you do not have update rights on are read-only in every column except Name; they are dimmed, and hovering one says why, for example You don't have write access to this row.
Open Options in the filter bar and click Table columns. It opens the same Manage Columns picker as the Items Table: tick or untick a column to show or hide it, type in Search columns to find one, drag the handle to reorder, then click Apply. Reset goes back to the default columns. Name is required and cannot be hidden.
While the table differs from the defaults, a dot shows on the Table columns button. When you hide columns, a pill such as 2 hidden columns appears in the filter bar: click it to open the picker, or clear it to bring the default columns back.
Your column choices are remembered in your browser and saved with a view, so different views can show different columns. Views saved before this option existed open as they always did.
The column headers are the Items Table's own. Drag the edge of a column in the header row to resize it (Drag to resize or double click to reset. Hold Shift to resize all columns.): a readout shows the width while you drag, holding Shift resizes every column in proportion, and double-clicking an edge resets that column. Resize handles are on the header row only. Column widths and the table width are remembered in your browser and saved with a view.
When the columns are wider than the table, scroll sideways to reach them. The leading columns stay put while the rest slide under them: the checkbox column and every column up to and including Name, so you always see which row you are on. This happens by itself; there is no setting. If those columns would fill the whole table (for example after you drag the table narrow), nothing is frozen, so every column stays reachable.
Click a cell, or move to it with the arrow keys and press Enter. On a cell you can edit, you can also just start typing: a letter or digit opens the editor, and a date editor starts with what you typed.
| Cell | Editor |
|---|---|
| Start date, Due date | Date picker. Changing a due date with Linked mode on cascades to dependents like a bar drag does. |
| Duration | Duration dialog: set the length and Save. |
| Progress | The Progress window. A ring shows the item's percentage with a short status (Not started, In progress, Complete or Set manually); for an item with children, a bar for each measure your organization tracks (Items, plus Points and Time estimate when those are in use) shows how much is done, such as 3 of 8 work items done, with Show detailed completion stats below. Turn on Progress from Lowest-Level Work to count every item at the bottom of the tree instead of direct children only; it is the same choice as in Options, so it changes the whole chart. Turn on Set progress manually to enter a Manual percentage completed between 0 and 100; that number then drives the bar fill regardless of child completion. Turn the switch off to go back to the worked-out value. Click Done. |
| Relationships | The item's Relationships dialog. Add or remove dependencies and related items; the lines on the timeline update. |
| Cycle / Board | Select a Board picker. Pick a board or clear it; the change saves at once, with a spinner in the cell, and a move into a time-based board's cycle moves the item's bar to that cycle's dates. |
| Assignee, Status and the other Items Table columns | The same editor as in the Items Table. |
| Name | Opens the item workspace, or the Edit Initiative / Edit Milestone dialog. |
The date, duration, progress and relationships editors show what they are changing under their title: the item's number and title, or for several rows, for example 3 items: I123 and 2 more. When an editor, a picker or the item drawer closes, focus returns to the cell, so you can carry on with the arrow keys.
While an edit is saving, the status strip reads Saving dates... or similar.
The first column holds a checkbox on every workstream and item row (initiatives and milestones cannot be ticked). Tick rows one by one, or Shift + click a checkbox to tick every row between the first ticked row and this one. The checkbox in the header ticks every row showing (rows hidden inside a collapsed parent are left out), or clears them all.
You can tick up to 25 rows. When the chart shows more than 25 rows that can be ticked, the header checkbox does not tick them all and its tooltip says so, for example Select all works on up to 25 rows. This roadmap shows 40.; if rows are ticked, clicking it clears them.
While rows are ticked, a banner under the table counts them (3 items selected., with (Max limit reached) at 25) and offers Clear.
Editing ticked rows. A Start date, Due date, Duration or Progress edit on a ticked row applies to every ticked row. Editing a row that is not ticked changes that row only, and the banner reminds you: Start date, due date, duration and progress edits apply to every ticked row. Editing a row that is not ticked changes that row only. Every other cell, Relationships included, edits its own row only. To change another field on all the ticked rows at once, use Edit in the row menu (below).
Workstreams often end up with children that spill past them. The table flags it and fixes it in one click:
The bar handles offer the same shortcut: with a workstream hovered, Shift + click its left or right handle to snap the start or due date to the earliest or furthest child.
Right-click a row, or click Options (vertical dots) at the end of its Name cell, to open the row menu.
Workstream and item rows get the Items Table's right-click menu. If the row you clicked is ticked, the menu acts on every ticked row; otherwise it acts on that row alone, which is ticked while the menu is open. It offers Open, Open in New Tab, Edit, Copy, Duplicate, the templates entries, and Archive, Delete or Unarchive, as your rights allow. Edit changes one field across all the rows the menu acts on, exactly like the Items Table's bulk edit, except that dates are left to the table's own date editors, so it has no Start Date or Due Date entry. It needs edit access on every one of those rows; otherwise it is greyed out and its tooltip says so.
When the menu acts on one row, it also has the chart's own entries:
| Action | Available on |
|---|---|
| Expand children / Collapse children | Rows with children |
| Create new then Work item or Workstream | Workstreams and items with children, when you can change the chart and create items (Workstream only under a workstream) |
| Remove from gantt | First-level workstreams and items directly under an initiative. Confirms with Remove; the item is untouched, only the chart changes. |
Entries that change something are greyed out, with the reason in their tooltip, when you cannot change this chart (You can't change this roadmap) or while a scenario is recording (Not available while a scenario is being recorded). Open, Copy, the expand and collapse entries and saving or exporting as a template still work.
Initiatives, milestones and locked rows keep the chart's own menu:
| Action | Available on |
|---|---|
| Edit (double-click also works) | Every row |
| Open in new tab | Locked workstreams and items |
| Expand children / Collapse children | Rows with children |
| Add existing workstreams or items | Initiatives |
| Create new then Work item or Workstream | Initiatives, when you can change the chart and create items |
| Delete | Initiatives and milestones. Deleting an initiative removes it and its rows from the chart; no items are deleted. |
Drag a row by its grab handle, in the first column, to change its order.
You can also move a row from the keyboard: Tab to its grab handle and press Space or Enter to pick it up, then ↑ / ↓ to move it one place among its siblings. Each step is saved as you go. Press Space to drop it, or Esc to let go. Screen readers announce each step. Moving a row to another initiative needs the mouse.
A row shows a grab handle only when you can change the chart and the row. While rows are ticked, rows cannot be moved; the handle's tooltip says Clear the selection to move a row. While Sort by Start Date is on in Options, rows cannot be reordered either; turn it off to drag them.
| Key | Action |
|---|---|
| Arrow keys | Move between cells |
| Cmd/Ctrl + ↑ / ↓ | Jump to the previous sibling (or the parent) / past the row's open children to the next sibling |
| Enter | Edit the focused cell (on Name, open the item) |
| Start typing | Open the focused cell's editor with what you typed |
| Esc | Cancel the edit |
| - / + or = | Collapse or expand the row, while its Name cell is focused |
| Shift + - | Collapse the deepest open level |
| Shift + = | Expand every collapsed initiative and workstream showing |
| Space or Enter on a grab handle | Pick up or drop the row; ↑ / ↓ moves it, Esc lets go |
More shortcuts, including the timeline ones, are in Keyboard shortcuts.
The two halves scroll together. Hovering a row highlights its bar and hovering a bar highlights its row, so you can read a date in the table and see where it lands on the timeline without losing your place. The highlight is a light tint of the item's own color across both halves (a row with no color of its own uses your theme's primary color); a row matched by search keeps its blue band. For the timeline side, continue with Navigating the timeline. For the toolbar as a reference, see Gantt Charts Toolbar.
Using Gantt Charts: Navigating the timeline
Move and resize bars, zoom and pan, snap work to a team's cycles, draw dependencies between bars, and choose whether a slipped date pushes dependent work.
Reports Overview
What the Measure Performance module contains, who can open it, how to pick a report, and how to drill in, save a view, and export to Excel.