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

# Configure Resource Fields

> Change which work item field the Nextedy GANTT resource view uses to identify resources, allowing you to display teams, departments, or custom groupings instead of individual assignees.

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>;
};

## Default Behavior

By default, the resource view uses the standard Polarion `assignee` field. Each row in the resource view represents one user, and workload is calculated based on work item assignments to that user.

## Step 1 -- Choose a Resource Field

The **Resource Field** widget parameter determines which work item field drives the resource view. You can point it to any field of the following types:

| Field Type            | Example                    | Use Case                              |
| --------------------- | -------------------------- | ------------------------------------- |
| **User**              | `assignee`                 | Standard per-user workload view       |
| **Enumeration**       | `primaryOwnership`, `team` | Team or department grouping           |
| **Multi Enumeration** | `teams`                    | Work items assigned to multiple teams |

## Step 2 -- Set the Resource Field Parameter

1. Open the Gantt page in **Edit mode**.
2. Click the widget gear icon to open **Widget Parameters**.
3. In the **Resource View** section, locate the **Resource Field** parameter.
4. Enter the field ID of your chosen resource field (e.g., `primaryOwnership`).
5. Click **Apply**.

<Tip title="Use team enumeration for cross-team views">
  In Polarion SAFe templates, the "Feature" work item type often has a `primaryOwnership` custom field of type Enumeration pointing to teams. Set Resource Field to `primaryOwnership` to see team-based resource allocation instead of individual users.
</Tip>

## Step 3 -- Verify Field Type Compatibility

The resource field must be one of the supported types listed above. If you configure a field that is not a User, Enumeration, or Multi Enumeration type, the resource view may not display resources correctly.

<Warning title="Custom fields must exist on displayed work item types">
  If the resource field does not exist on a work item type shown in the Gantt, those work items will appear as unassigned in the resource view. Verify the field is defined on all relevant work item types.
</Warning>

## Example: Team-Based Resource View

To show teams instead of individual users:

1. Create a custom field `team` of type **Enum > Nextedy Team** on your work item type.
2. Assign work items to teams using this field.
3. Set **Resource Field** to `team` in the Gantt widget parameters.
4. Enable **Show Resource View**.

The resource view now shows one row per team with workload markers reflecting all work items assigned to that team.

## Example: Multi-Team Assignments

If a work item can belong to multiple teams, use a **Multi Enumeration** field:

1. Create a custom field `teams` of type Multi Enumeration.
2. A single work item assigned to both "Team Alpha" and "Team Beta" will contribute workload to both resource rows.

## Step 4 -- Customize the Resource Label

The **Resource Label** parameter controls the column header text in the resource view. Set it to a descriptive name such as "Team" or "Department" to match the field you selected.

<Tip title="Combine with resource load modes">
  The resource field configuration works with all four [resource load calculation modes](/gantt/guides/resources/resource-view). When using Assignment Allocation mode with a team field, you get team-level capacity percentages.
</Tip>

## Verification

You should now see:

* Resource view rows labeled with values from your chosen field (teams, departments, etc.) instead of individual user names
* Workload markers distributed correctly across the resource rows
* Work items without a value in the resource field appearing in the "Unassigned" row (if Show Unassigned is enabled)

## See Also

* [Set Up the Resource View](/gantt/guides/resources/resource-view)
* [Set Up a Cross-Team Gantt Chart](/gantt/guides/resources/cross-team-gantt)
* [Set Up Team Assignments Gantt](/gantt/guides/resources/team-assignments-gantt)
* [Filter by Resource and Allocation](/gantt/guides/filtering/filter-by-resource)

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