Skip to main content

Prerequisites

  • Working calendars enabled in the Gantt widget (see Set Up Work Item Calendars)
  • Team assignments configured with the appropriate work item type
  • Access to Administration > Configuration Properties
1

Define the Modifier Fields

Capacity modifiers use two custom fields on your Team work items. Each field holds a percentage value (0-100) representing a capacity reduction.Add the following properties under Administration > Configuration Properties:
nextedy.gantt.capacityModifierAField=capacityModA
nextedy.gantt.capacityModifierBField=capacityModB
Replace capacityModA and capacityModB with the actual field IDs on your Team work items.
PropertyPurposeExample Value
nextedy.gantt.capacityModifierAFieldField ID for modifier A (permanent reduction)capacityModA
nextedy.gantt.capacityModifierBFieldField ID for modifier B (time-limited reduction)capacityModB
nextedy.gantt.capacityModifierBFieldDayLimitNumber of days from today within which modifier B is zeroed30
2

Understand the Capacity Formula

The Gantt calculates effective capacity using both modifiers:
effectiveCapacity = base * (1 - (capModA + capModB) / 100)
For example, if a resource has 8 working hours per day, modifier A is 25%, and modifier B is 10%:
effectiveCapacity = 8 * (1 - (25 + 10) / 100) = 8 * 0.65 = 5.2 hours
diagram
3

Configure the Modifier B Day Limit

Modifier B includes a time-horizon feature: within a specified number of days from today, modifier B is zeroed out. This allows you to model scenarios where a future capacity reduction is planned but should not affect near-term scheduling.
nextedy.gantt.capacityModifierBFieldDayLimit=30
With this setting, modifier B is applied only to dates more than 30 days in the future. For dates within the next 30 days, only modifier A affects the capacity calculation.
Use modifier A for permanent capacity reductions (such as part-time allocation to the project) and modifier B for planned future changes (such as an upcoming role change or project transition). The day-limit ensures near-term planning uses current capacity while long-term planning reflects the expected change.
4

Enable Team Capacity Modifiers

To activate team-level capacity modifiers, add this property:
nextedy.gantt.useTeamCapacityModifiers=true
When enabled, team modifiers (fields A and B) reduce effective resource capacity in the resource view. The modifiers are read from the Team work item that each user is assigned to.
The fields specified by nextedy.gantt.capacityModifierAField and nextedy.gantt.capacityModifierBField must exist as custom fields on the Team work item type. If the fields are missing, the modifiers are silently ignored and capacity is calculated without reduction.
5

Enable Working Calendars in the Widget

Open the Gantt widget parameters and navigate to Working Calendars:
  1. Set Use Working Calendar to Yes
  2. Set Load User Calendars to Yes
  3. Set Load Team Assignments to Yes
The capacity modifiers are applied during calendar building, combining the base working hours from the user’s calendar with the percentage reductions from the user’s Team work item.
When a user has multiple team assignment work items, the capacity contributions from all assignments are summed together with the user’s calendar to build their effective daily capacity. Keep the total across all assignments realistic (typically not exceeding 100%) — additive stacking can otherwise overstate a user’s availability and hide real overallocation.

Verify

You should now see that resource view allocation markers reflect the reduced capacity for users with modifier fields set on their team assignments. A resource with a 25% modifier A shows 6 hours of available capacity per day (instead of 8), and tasks assigned to that resource display higher utilization percentages accordingly.

See Also

Last modified on July 10, 2026