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

## Where a figure comes from

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

## How sub-items are weighed

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.

## A value typed on a parent

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.

## Completed items

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.

## Items that do not count

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

## What a figure shows

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

## Example

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

## Things that may surprise you

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

## Next

- [How values roll up to a parent](../rollups/)
- [Formula fields](../../types-and-fields/formula-fields/)
