Track Progress: Gantts

Using Gantt Charts: Navigating the table

What each column in the Gantt table shows, how to add Items Table columns, which cells you can edit for initiatives, milestones, workstreams and items, how to tick rows and edit them together, the row menu, how to set dates from descendants, and how to reorder rows with the mouse or the keyboard.

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.

Columns

These columns show by default:

ColumnShowsEditable for
NameThe 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 dateThe 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 dateThe 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
DurationStart to due, humanized (for example 9 days).Workstreams and items
Cycle / BoardThe 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
ProgressPercent 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
RelationshipsLinked 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

Items Table columns

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.

ColumnEditable
Assignee, Status, Priority, Tags, TeamYes
Parent, Item TypeYes
Time Spent, Point Estimate, Time EstimateYes
Watchers, Blocked ReasonYes
Creator, Date AddedOnly with the Backdate Item History permission (see Correcting an item's real history)
Subtasks, Completion Date, Children Point Effort, Children Time Estimate, Children Time SpentNo, display only
One column per custom fieldYes, 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.

Choose columns

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.

Resize columns

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.

Scroll sideways

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.

Edit a cell

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.

CellEditor
Start date, Due dateDate picker. Changing a due date with Linked mode on cascades to dependents like a bar drag does.
DurationDuration dialog: set the length and Save.
ProgressThe 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.
RelationshipsThe item's Relationships dialog. Add or remove dependencies and related items; the lines on the timeline update.
Cycle / BoardSelect 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 columnsThe same editor as in the Items Table.
NameOpens 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.

Tick rows

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).

Set dates from descendants

Workstreams often end up with children that spill past them. The table flags it and fixes it in one click:

  • A shaded hint appears in the Start date or Due date cell when a descendant falls outside the workstream. The tooltip names the earliest or furthest descendant date.
  • Shift + click the cell to set the workstream's date to that descendant date.
  • A Date missing cell works the same way: Shift + click sets the inferred date shown in the tooltip.

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.

Row actions

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:

ActionAvailable on
Expand children / Collapse childrenRows with children
Create new then Work item or WorkstreamWorkstreams and items with children, when you can change the chart and create items (Workstream only under a workstream)
Remove from ganttFirst-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:

ActionAvailable on
Edit (double-click also works)Every row
Open in new tabLocked workstreams and items
Expand children / Collapse childrenRows with children
Add existing workstreams or itemsInitiatives
Create new then Work item or WorkstreamInitiatives, when you can change the chart and create items
DeleteInitiatives and milestones. Deleting an initiative removes it and its rows from the chart; no items are deleted.

Reorder rows

Drag a row by its grab handle, in the first column, to change its order.

  • Rows reorder within the same parent: initiatives and milestones among themselves at the top level, siblings inside a workstream, items inside an initiative.
  • A first-level workstream or item can be dropped onto a different initiative to move it there. The status strip shows Reordering... or Moving... while it saves.
  • Reordering siblings inside a workstream changes their rank in the workstream itself, not just on the chart.

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.

Keyboard

KeyAction
Arrow keysMove between cells
Cmd/Ctrl + ↑ / ↓Jump to the previous sibling (or the parent) / past the row's open children to the next sibling
EnterEdit the focused cell (on Name, open the item)
Start typingOpen the focused cell's editor with what you typed
EscCancel 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 handlePick up or drop the row; ↑ / ↓ moves it, Esc lets go

More shortcuts, including the timeline ones, are in Keyboard shortcuts.

Table and timeline together

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.