Progress settings | DevSamurai

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:

Open your board in TeamBoard ProScheduler
Go to Board settings > Select Gantt

CleanShot 2025-12-19 at 10.23.34@2x-20251219-032340.jpg

What is task progress?

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

Default: Users manually update task progress, giving them full control over the progress percentage.
Jira Field: Task progress is automatically calculated based on values from a linked Jira field (e.g., Time Spent, Number fields).
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 You can drag the progress slider directly on the taskbar in the Gantt chart to visually adjust the completion percentage. You can type the progress number directly in the Progress (Teamboard) column from the table view. 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.

Default

Based on descendants

Task Progress

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

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.

CleanShot 2025-12-21 at 00.05.52@2x-20251220-170558.jpg

Example

CleanShot 2025-12-21 at 01.10.35@2x-20251220-181051.jpg

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:

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.

CleanShot 2025-12-20 at 22.28.52@2x-20251220-152901.jpg

Learn more: How to add a number field to your Jira Projects.

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.

CleanShot 2025-12-20 at 22.29.54@2x-20251220-153004.jpg

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

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:

CleanShot 2025-07-15 at 09.54.27@2x-20250715-025433.jpg

Example:

CleanShot 2025-12-20 at 23.30.49@2x-20251220-163111.jpg

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

CleanShot 2025-12-20 at 23.53.27@2x-20251220-171338.jpg

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:

CleanShot 2025-12-21 at 00.20.12@2x-20251220-174606.jpg

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:

CleanShot 2025-12-21 at 00.20.12@2x-20251220-174918.jpg

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.

Auto

Based on descendants

Task Progress

Progress is calculated automatically using the formula:

CleanShot 2025-07-15 at 13.32.15@2x-20250715-063218.jpg

Example

Task 1 Progress = 8 / 24 = 33.33%

CleanShot 2025-12-21 at 01.13.43@2x-20251220-181348.jpg

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.