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

# Resource View Parameters

> Nextedy GANTT provides a resource view panel below the Gantt chart that displays per-resource workload allocation with color-coded capacity markers.

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

## Resource View Widget Parameters

| Name                            | Type    | Default         | Description                                                                                                                            |
| ------------------------------- | ------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `Show Resource View`            | Boolean | `false`         | Master toggle that enables the resource view panel below the Gantt chart. All parameters below require this to be `true`.              |
| `Resource Load Calculation`     | Enum    | See application | Controls how resource utilization is calculated and displayed. See [Load Modes](#load-modes) below.                                    |
| `Resource Field`                | String  | See application | The Polarion work item field used to determine the assigned resource (user ID). Drives the resource view rows and the resource filter. |
| `Resource Label`                | String  | See application | Controls the display label for each resource row in the resource view.                                                                 |
| `Show Unassigned`               | Boolean | See application | When enabled, displays an "Unassigned" row for tasks that have no resource assignment.                                                 |
| `Items per resource - OK limit` | Integer | `1`             | The threshold number of items or hours below which the resource marker displays in the "OK" (green) color.                             |
| `View Height`                   | Integer | `250`           | The pixel height of the resource view panel.                                                                                           |

<Warning title="Parameter Visibility">
  The `Resource Load Calculation`, `Resource Field`, `Resource Label`, `Show Unassigned`, `Items per resource - OK limit`, and `View Height` parameters only appear in the widget parameter editor after you set **Show Resource View** to `Yes`. This progressive disclosure avoids clutter when the resource view is not in use.
</Warning>

## Load Modes

The `Resource Load Calculation` parameter determines how workload is computed for each resource:

| Mode                  | Value        | Description                                                                                               |
| --------------------- | ------------ | --------------------------------------------------------------------------------------------------------- |
| Leaf Items Count      | `num`        | Counts the number of (leaf) items assigned to the resource in each time period.                           |
| Estimate + Spent      | `time`       | Sums each resource's time estimate plus time spent, based on task duration and the working calendar.      |
| Remaining Estimate    | `remaining`  | Sums the remaining estimated hours for each resource in the visible time range.                           |
| Assignment Allocation | `allocation` | Calculates the allocation percentage against the resource's available capacity from the working calendar. |

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/reference/widget-parameters/resource-view/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=f695f08a787ac303a737568ce41cdb89" alt="diagram" style={{ maxWidth: "620px", width: "100%" }} width="620" height="280" data-path="gantt/diagrams/reference/widget-parameters/resource-view/diagram-1.svg" />
</Frame>

## Resource Marker Colors

The resource view displays color-coded markers for each time cell:

| Marker State         | Default Color       | Description                                                             |
| -------------------- | ------------------- | ----------------------------------------------------------------------- |
| Within capacity (OK) | `#4CAF50` (green)   | The resource is at or below the configured capacity threshold.          |
| Over capacity        | Red/orange gradient | The resource exceeds the capacity threshold, indicating overallocation. |

You can customize these colors using the `resourceMarkersColorConfig` property in [Color and Styling Properties](/gantt/reference/configuration/color-properties).

## Leaf Task Filtering

The `onlyLeafTasks` configuration property affects resource view calculations:

* When `onlyLeafTasks` is `true`, only leaf tasks (tasks with no children) are counted in resource allocation.
* Parent or summary tasks (presentation mode `Derived Schedule`) are excluded from workload calculations.
* Work items that have a parent presentation mode but no visible children due to filtering are treated as leaf items and included in calculations.

<Info title="Verify in application">
  The exact behavior of filtered workpackages without visible children in resource calculations may vary by version. Verify the resource count behavior in your specific Gantt version.
</Info>

## Unassigned Resource Row

Tasks with no value in the configured `Resource Field` are grouped under a synthetic "Unassigned" resource row. This row uses the internal constant `UNASSIGNED_ID` and appears at the bottom of the resource view when `Show Unassigned` is enabled.

## Team-Based Resource View

When team assignments are enabled (via [Team and Resource Properties](/gantt/reference/configuration/team-properties)), the resource view displays team rows instead of individual user rows. In team mode:

* Each team appears as a resource row with aggregated workload from all assigned tasks.
* The lightbox shows a team picker instead of a user picker for the resource field.
* Capacity is derived from team assignment records rather than individual working calendars.

## Configuration Example

To enable a resource view showing estimate-and-spent allocation:

1. Open **Widget Properties** for the Gantt widget.
2. In the **Resource View** section, set **Show Resource View** to `Yes`.
3. Set **Resource Load Calculation** to `Estimate + Spent`.
4. Set **Resource Field** to the Polarion field holding the assignee (e.g., `assignee`).
5. Optionally enable **Show Unassigned** to see unassigned tasks.
6. Save the widget parameters.

<Tip title="Working Calendars for Accurate Load">
  For accurate resource load calculations, enable [Working Calendars](/gantt/reference/widget-parameters/working-calendars) so that non-working days, holidays, and per-user schedule exceptions are reflected in the capacity values.
</Tip>

## Related Pages

* [Working Calendars Parameters](/gantt/reference/widget-parameters/working-calendars) -- calendar settings affecting capacity calculations
* [Color and Styling Properties](/gantt/reference/configuration/color-properties) -- resource marker color customization
* [Team and Resource Properties](/gantt/reference/configuration/team-properties) -- team-based assignment configuration
* [View Resource Allocation](/gantt/getting-started/first-resource-view) -- tutorial for first-time setup

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