Skip to content
Search

How progress is calculated

Progress shows how much of an item is done, as a percentage. On an item without sub-items, the figure comes from the field’s Source. On a parent, Teamhood calculates the figure from the items below it. Each sub-item counts by its weight, so a long task moves its parent more than a short one.

No calculated figure is saved. Every figure is calculated again when you look at it, so a change on a sub-item shows on its parent at once.

The Source setting decides the figure of an item without sub-items.

  • Typed: the percentage someone typed. An item with no typed value shows no figure, and counts as 0% in its parent.
  • Completion: 0% while the item is open, and 100% once it is completed.
  • Tracked time: the time tracked on the item divided by its estimate, up to 100%. An item without an estimate has no figure.
  • Formula: a number from 0 to 1 that a formula calculates, so 0.45 shows as 45%. The formula cannot use ROLLUP() or RATE().

You always type a percentage. Typing 45 stores 45%, and typing 0.45 stores 0.45%.

The Weight setting decides how much each sub-item counts. In a new organization, the weight is Duration (d).

  • A sub-item counts by its own weight. A sub-item without one counts as the value in No Duration counts as, which is 1 day in a new organization. Choosing another weight sets it back to 1, in the new weight’s unit.
  • A sub-item with sub-items of its own counts by the total weight below it. With Parent weight set to Own Duration, it counts by its own value instead, when it has one.
  • With Each item the same, every sub-item counts the same.
  • A weight of 0 leaves a sub-item out of its parent’s figure. When every weight is 0, every sub-item counts the same.

With Typed on parents set to Used, a value typed on a parent replaces its calculated figure. A pin marks it, and the parent above it counts the typed value. When the source is not Typed, the same pin marks a value typed on an item without sub-items, since it replaces the figure that source gives.

To use the calculated figure again, click the figure, then click the pin next to the typed value. Its tooltip says Use calculated. In item details, the pin after the value does the same.

With Ignored, a typed value is used only on an item without sub-items, and only when the source is Typed. Any other typed value is kept, but not used: the figure skips it, and automations read it as empty.

With Completed items count as 100% on, a completed item counts as 100%. This applies only when nothing below the item is still open. A completed parent with an open sub-item keeps its calculated figure, unless a value typed on it replaces that figure, as the automations below can do.

An organization starts with three automations that keep Progress and Completed in step:

  • Typing 100% marks the item completed.
  • Changing a typed 100% to another value, or clearing it, marks the item not completed.
  • Marking the item completed types 100% on it.

The first two are rules on the Progress field, and the third is a rule on Completed. You can change them or switch them off in each field’s automations.

  • An item with a status in Leave out does not count, and neither do its sub-items. In a new organization, Cancelled is left out.
  • An item of a type the field does not apply to has no figure. Its sub-items count in the parent above it.
  • A figure is rounded down to a whole percent, so 100% shows only when the work is done.
  • A calculated figure is bold. A typed figure is not.
  • Clicking a parent’s figure opens a panel. It lists each sub-item with its weight and figure. An asterisk marks a value that counts something missing, on that row or below it, and a bold weight is the total of the sub-item’s own sub-items. Legend, at the bottom of the panel, explains each mark the panel shows, and stays open or closed as you last left it in this browser. Clicking a mark opens it too.
  • A group header and the total row weigh the top-level items they cover in the same way.

A project has two tasks. Task A takes 10 days and is 50% done. Task B takes 30 days and is 10% done. The project shows (10 × 50% + 30 × 10%) ÷ 40 days, which is 20%.

  • Budget is not offered as a weight. In a new organization only projects have a budget, so the items below a project have none to weigh. A formula source can still use Budget.
  • A figure calculated from Budget needs financial access. When the field’s formula uses Budget, someone without access to financial data sees a dash instead of the calculated figure. A typed figure still shows.
  • Filters and sorting use the figure you see. A filter compares the rounded figure. An item without a figure matches only is empty.
  • Automations read the typed value only. A rule can react to a value someone typed, but not to a calculated figure.
  • Reopening an item keeps its 100%. No automation changes the typed value when an item stops being completed, so it shows 100% until someone types another value.
  • Completing a parent replaces its calculated figure. The automation types 100% on the parent. With Typed on parents set to Used, that value replaces the calculated figure, even while a sub-item is still open.
  • Use calculated reopens a completed item. It clears the typed 100%, and clearing it marks the item not completed.
  • Schedule bars do not use this field. They still fill by the time tracked divided by the estimate.