Configure Capacity Modifier Fields

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

Step 1: Define the Modifier Fields

Capacity modifiers use two custom fields on your team assignment 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 assignment work items.

Property	Purpose	Example Value
`nextedy.gantt.capacityModifierAField`	Field ID for modifier A (permanent reduction)	`capacityModA`
`nextedy.gantt.capacityModifierBField`	Field ID for modifier B (time-limited reduction)	`capacityModB`
`nextedy.gantt.capacityModifierBDayLimit`	Number of days from today within which modifier B is zeroed	`30`

Step 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

Step 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.capacityModifierBDayLimit=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.

Step 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 team assignment work items linked to each user.

The fields specified by nextedy.gantt.capacityModifierAField and nextedy.gantt.capacityModifierBField must exist as custom fields on the work item type used for team capacity records. If the fields are missing, the modifiers are silently ignored and capacity is calculated without reduction.

Open the Gantt widget parameters and navigate to Working Calendars:

Set Use Working Calendar to Yes
Set Load User Calendars to Yes
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 team assignment work items.

When a user has multiple team assignment work items, the capacity values from all assignments are aggregated additively. Ensure that total capacity percentages do not exceed 100% across all assignments to avoid negative effective capacity.

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.

Getting Started

Concepts

Guides

Reference

FAQ

Prerequisites

Step 1: Define the Modifier Fields

Step 2: Understand the Capacity Formula

Step 3: Configure the Modifier B Day Limit

Step 4: Enable Team Capacity Modifiers

Step 5: Enable Working Calendars in the Widget

Verify

See Also

Getting Started

Concepts

Guides

Reference

FAQ

​Prerequisites

​Step 1: Define the Modifier Fields

​Step 2: Understand the Capacity Formula

​Step 3: Configure the Modifier B Day Limit

​Step 4: Enable Team Capacity Modifiers

​Step 5: Enable Working Calendars in the Widget

​Verify

​See Also

Prerequisites

Step 1: Define the Modifier Fields

Step 2: Understand the Capacity Formula

Step 3: Configure the Modifier B Day Limit

Step 4: Enable Team Capacity Modifiers

Step 5: Enable Working Calendars in the Widget

Verify

See Also