> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Team and Resource Properties

> Nextedy GANTT supports dynamic team management through dedicated work item types.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

Set these properties in **Administration > Configuration Properties**.

## Team Work Item Type Properties

| Name                                       | Type     | Default           | Description                                                                                                                                                    |
| ------------------------------------------ | -------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.teamWorkItemType`           | `String` | `team`            | Polarion work item type ID treated as a Team. Teams appear as resource groups in the resource view. Since version **25.5.0**.                                  |
| `nextedy.gantt.teamAssignmentWorkItemType` | `String` | `teamAssignment`  | Polarion work item type ID treated as a Team Assignment. Team assignments define per-user allocation periods under a team. Since version **25.5.0**.           |
| `nextedy.gantt.teamManagementProjectId`    | `String` | *current project* | Polarion project ID where team and team assignment work items are stored. Falls back to the current project if not set. Enables cross-project team management. |

<Tip title="Custom Type IDs">
  Starting with version **25.5.0**, you can use custom work item type IDs for teams and assignments. Set `nextedy.gantt.teamWorkItemType` and `nextedy.gantt.teamAssignmentWorkItemType` to match your project's work item type configuration.
</Tip>

## Team Assignment Structure

Teams are defined using two work item types linked by the `assignment` link role:

| Work Item Type      | Purpose                                                                                             | Required Fields                              |
| ------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| **Team**            | Container representing a team or organizational unit. Shown as a resource group in the Gantt chart. | Name                                         |
| **Team Assignment** | Child item specifying a user's allocation to a team for a defined period.                           | Assignee, Start Date, End Date, Allocation % |

<Warning title="Link Requirement">
  Each Team Assignment work item **must be linked** to a parent Team work item using the `assignment` link role. Assignments not associated with a parent team are **ignored** during capacity calculations.
</Warning>

## Team Capacity Modifier Properties

Capacity modifiers represent the percentage of time resources spend on unplanned work or account for future uncertainty.

| Name                                           | Type      | Default         | Description                                                                                                                                                                                 |
| ---------------------------------------------- | --------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.useTeamCapacityModifiers`       | `Boolean` | `false`         | Enable team-level capacity modifiers. When `true`, modifier A and B fields reduce effective resource capacity.                                                                              |
| `nextedy.gantt.capacityModifierAField`         | `String`  | *empty*         | Name of the custom field on the Team work item containing capacity modifier A. This modifier represents **unplanned work** (meetings, emails, etc.) and is applied to all tasks.            |
| `nextedy.gantt.capacityModifierBField`         | `String`  | *empty*         | Name of the custom field on the Team work item containing capacity modifier B. This modifier represents **future uncertainty** and is applied only to tasks beyond the day limit threshold. |
| `nextedy.gantt.capacityModifierBFieldDayLimit` | `Integer` | See application | Number of days in the future after which capacity modifier B is applied. Set to `-1` to always apply modifier B.                                                                            |

### Capacity Modifier Behavior

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/reference/configuration/team-properties/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=27bb4cd02b048a737ac493c1959dcf1d" alt="diagram" style={{ maxWidth: "780px", width: "100%" }} width="780" height="180" data-path="gantt/diagrams/reference/configuration/team-properties/diagram-1.svg" />
</Frame>

* **Modifier A** -- Applied to all tasks regardless of timing. Represents the percentage of time spent on unplanned activities.
* **Modifier B** -- Applied only to tasks that are `capacityModifierBFieldDayLimit` days or more in the future. Represents planning uncertainty.

## Resource Configuration Properties

| Name                                       | Type      | Default         | Description                                                                                                                                                                      |
| ------------------------------------------ | --------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.phantomResourceHoursPerDay` | `Integer` | See application | Default working hours per day for phantom (unresolvable) resources when no calendar is available. Phantom resources appear when an assigned user cannot be resolved in Polarion. |
| `nextedy.gantt.loadResourcesFromCsv`       | `Boolean` | `false`         | Load resource definitions from a CSV file instead of from Polarion users. Use for large installations where Polarion user loading is too slow.                                   |

## Resource View Behavior

The resource view supports multiple resource source modes:

| Source Mode           | Description                                                                                                   |
| --------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Assignee**          | Default. Resources are derived from the `assignee` field on work items. Shows individual users.               |
| **Team Custom Field** | Set the Resource Field to a team enumeration field (e.g., `primaryOwnership`) to show team-level assignments. |
| **Multi Enumeration** | Resource Field can point to a multi-enum field, allowing a work item to be assigned to multiple teams.        |
| **Categories**        | Resource Field can point to a Polarion categories field for category-based grouping.                          |

<Note title="Resource Field Types">
  The Resource Field widget parameter must point to a field of type **User**, **Enumeration** (including synthetic enumerations like `@user`), or **Multi Enumeration**.
</Note>

## Configuration Example

To set up team assignments with custom type IDs and capacity modifiers:

```properties theme={null}
nextedy.gantt.teamWorkItemType=group
nextedy.gantt.teamAssignmentWorkItemType=groupAssignment
nextedy.gantt.teamManagementProjectId=TeamManagement
nextedy.gantt.useTeamCapacityModifiers=true
nextedy.gantt.capacityModifierAField=capaModA
nextedy.gantt.capacityModifierBField=capaModB
nextedy.gantt.capacityModifierBFieldDayLimit=10
```

To use a global calendar holder:

```properties theme={null}
nextedy.gantt.calendarHolder=calendarUser
```

## Related Pages

* [Calendar and Working Hours Properties](/gantt/reference/configuration/calendar-properties) -- working calendar configuration
* [Resource View Parameters](/gantt/reference/widget-parameters/resource-view) -- widget-level resource view settings
* [General Administration Properties](/gantt/reference/configuration/general-properties) -- global Gantt properties
* [Default Configuration Values](/gantt/reference/configuration/default-values) -- default widget property values

<LastReviewed date="2026-07-02" />