Skip to main content
Skip table of contents

Progress settings

How to access progress settings

In TeamBoard ProScheduler, task progress can be calculated using three methods, giving you flexibility at both the individual task and parent task levels.

To access the configuration:

  1. Open your board in TeamBoard ProScheduler

  2. Go to Board settings > Select Gantt

What is task progress?

Task progress represents the percentage of completion for a specific task. It can be configured in several ways:

  1. Default: Users manually update task progress, giving them full control over the progress percentage.

  2. Jira Field: Task progress is automatically calculated based on values from a linked Jira field (e.g., Time Spent, Number fields).

  3. Auto: Progress is automatically calculated by comparing the logged time to the scheduled time.

What is ascendant?

An ascendant is a parent or higher-level task within a hierarchy that includes or oversees descendant (child) tasks. There are two options for calculating its progress:

Based on descendants

  • The progress of the ascendant task is automatically calculated based on the progress of its descendant tasks.

  • The progress of the ascendant task cannot be edited directly; it updates automatically as the descendant tasks are updated.

Based on actual value

  • The parent task's progress is determined by its own progress field, regardless of the progress of its descendant tasks.

How to configure task progress

OPTION 1 Default

Default

Based on descendants

Task Progress

  1. You can drag the progress slider directly on the taskbar in the Gantt chart to visually adjust the completion percentage.

CleanShot 2025-12-19 at 11.10.52-20251219-041110.gif
  1. You can type the progress number directly in the Progress (Teamboard) column from the table view.

CleanShot 2025-12-19 at 11.08.57-20251219-040920.gif

Ascendant Progress

  • Cannot be edited directly — the parent task’s progress is updated automatically as descendant (child) tasks change.

  • Parent progress = average progress of all child work items.

Example

Epic 1 Progress

  • Task 1: 33.33%

  • Task 2: 25%

  • Task 3: 68.75%

→ Epic 1 Progress = (33.33%+ 25%+ 68.75%) / 3 = 42.36%

Task 3 Progress

  • Subtask 3.2: 100%

  • Subtask 3.1: 37.5%

→ Task 3 Progress = (100% + 37.5%) 2 = 68.75%

Actual value

Ascendant progress

  • This behavior is the same as the Default option for task progress.

  • The parent task’s progress is determined by its own progress field and is independent of the progress of its descendant (child) tasks.

OPTION 2 Jira field

TeamBoard ProScheduler allows automated task progress calculation using the Jira Field option, ensuring TeamBoard stays fully in sync with actual Jira values.

This option supports two main types of linked Jira fields:

  1. Number Field (0–100)

You can link a Jira custom number field (with values from 0 to 100) to represent the percentage of task completion. Any updates made in Jira or by dragging the progress slider in the Gantt chart are reflected immediately.

  1. Time Tracking (Time Spent)

TeamBoard can also calculate progress using Jira’s native Time Spent field. This ensures progress is always calculated accurately based on real work logged in Jira.

Jira field

Based on descendants

NUMBER FIELD

You can easily update the progress by entering a number (0-100) in the Jira number field, or by hovering over the progress bar and dragging the slider.

CleanShot 2025-12-20 at 22.39.13-20251220-153952.gif

TIME SPENT

Task Progress

  • Progress is calculated automatically using the formula:

Example:

Task 1 has:

  • Time Spent: 1 day

  • Time Remaining: 2 days

→ Progress calculation: 1 ÷ (1 + 2) = 33.33%

Ascendant Progress

CASE 1 Parent task does NOT have Time Spent / Time Remaining

Example

Epic 1 has:

  • Task 1: 33.33%

  • Task 2: 50%

  • Task 3: 55.17%

→ Progress of Epic 1 = (33.33 + 50 + 55.17) / 3 = 46.17%

CASE 2 Parent task has Time Spent / Time Remaining

→ Parent task Progress:

Example

EXAMPLE 1 Epic 1 includes itself and its child work items:

  • Total Time Spent = 3d6h + 1d + 1d + 5h + 1d + 3h = 7d 6h

  • Total Time Remaining = 1d2h + 2d + 1d + 3h + 1d + 2h = 5d 7h

→ Epic 1 Progress (%) = 7d 6h / (7d 6h + 5d 7h) = 56.88%

EXAMPLE 2 Task 3 includes itself and its child work items:

  • Total Time Spent = 5h + 1d + 3h = 2d

  • Total Time Remaining = 3h + 1d + 2h = 1d 5h

→ Task 3 Progress (%) = 2d / (2d + 1d 5h) = 55.17%

Actual value

Ascendant progress

  • This behavior is the same as the Jira Field option for task progress.

  • The parent task’s progress is determined by its own progress field and is independent of the progress of its descendant (child) tasks.

OPTION 3 Auto

Auto

Based on descendants

Task Progress

  • Progress is calculated automatically using the formula:

Example

Task 1 Progress = 8 / 24 = 33.33%

Ascendant progress

  • Cannot be edited directly — the parent task’s progress is updated automatically as descendant (child) tasks change.

  • Parent progress = average progress of all child work items.

Example

Epic 1 Progress

  • Task 1: 33.33%

  • Task 2: 25%

  • Task 3: 68.75%

→ Epic 1 Progress = (33.33%+ 25%+ 68.75%) / 3 = 42.36%

Task 3 Progress

  • Subtask 3.2: 100%

  • Subtask 3.1: 37.5%

→ Task 3 Progress = (100% + 37.5%) 2 = 68.75%

Actual value

Ascendant progress

  • This behavior is the same as the Auto option for task progress.

  • The parent task’s progress is determined by its own progress field and is independent of the progress of its descendant (child) tasks.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.