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

# Set Up a Cross-Team Gantt Chart

> Configure a Nextedy GANTT chart that shows work items grouped by team in the resource view, giving you a clear picture of each team's workload without drilling into individual assignments.

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

## Prerequisites

* Gantt version **23.4.0** or later
* A custom field of type **Enum > Nextedy Team** on your work item types

<Steps>
  <Step title="Create a Team Custom Field">
    1. Open **Administration > Custom Fields** for your project.
    2. Create a new custom field with ID `team` (or a similar name).
    3. Set the field type to **Enumeration** and select **Nextedy Team** as the enumeration source.

    The Nextedy Team enumeration automatically lists all work items of type "Team" in your project as selectable options.

    4. Add this field to the relevant work item types (e.g., Work Package, Feature).
  </Step>

  <Step title="Assign Work Items to Teams">
    Open each work item and set the `team` field to the appropriate team. This tells the Gantt which team is responsible for each work item.
  </Step>

  <Step title="Configure the Gantt Widget">
    1. Open the Gantt page in **Edit mode**.
    2. Open **Widget Parameters**.
    3. Configure the following settings:

    | Parameter                 | Value                           |
    | ------------------------- | ------------------------------- |
    | **Resource Field**        | `team` (your custom team field) |
    | **Show Resource View**    | Yes                             |
    | **Load Team Assignments** | Yes                             |

    4. Click **Apply**.

    <Note title="Load Team Assignments requires working calendars">
      The **Load Team Assignments** parameter only becomes visible after you enable **Use Working Calendar** and **Load User Calendars** under the **Working Calendars** section. Enable those two options first if you do not see **Load Team Assignments**. See [Working Calendars Parameters](/gantt/reference/widget-parameters/working-calendars) for the full dependency chain.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/guides/resources/cross-team-gantt/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=f34e0ed1bf63b25e9dfe1061b1dff33a" alt="diagram" style={{ maxWidth: "360px", width: "100%" }} width="360" height="420" data-path="gantt/diagrams/guides/resources/cross-team-gantt/diagram-1.svg" />
    </Frame>
  </Step>

  <Step title="Choose a Load Calculation Mode">
    For cross-team views, the most common calculation modes are:

    * **Leaf Items Count** -- shows how many work items each team has in each time period
    * **Estimate + Spent** -- shows the total effort (hours) distributed across the team's scheduled work

    Select the appropriate mode in **Resource Load Calculation** within the Resource View parameters.

    <Tip title="Use Assignment Allocation for capacity percentage">
      If your teams have assignment work items defining per-user allocation percentages, select **Assignment Allocation** mode to see capacity as percentages rather than hours.
    </Tip>
  </Step>

  <Step title="Filter by Team (Optional)">
    You can pre-filter the Gantt to show only a specific team's work items by passing a `team` query parameter in the page URL. This limits both the task list and the resource allocation calculations to the selected team.

    <Warning title="Team members with less than 50% allocation appear greyed out">
      In the resource view, users allocated below 50% to a team may appear with grey markers instead of colored ones. Verify team assignment percentages if resources appear unexpectedly greyed out.
    </Warning>

    <Warning title="Multi-project team management">
      If your teams span multiple Polarion projects, consider using an [external team management project](/gantt/guides/resources/external-team-management) to centralize team definitions and capacity data.
    </Warning>
  </Step>
</Steps>

## Verification

You should now see:

* One row per team in the resource view below the Gantt chart
* Work item counts or effort hours displayed in each cell per team
* Color-coded cells indicating whether each team is within capacity (green) or overallocated (red)
* The team custom field values reflected in the resource column labels

## See Also

* [Set Up the Resource View](/gantt/guides/resources/resource-view)
* [Configure Resource Fields](/gantt/guides/resources/resource-field-configuration)
* [Set Up Team Assignments Gantt](/gantt/guides/resources/team-assignments-gantt)
* [Set Up a Release Gantt with Teams](/gantt/guides/resources/release-gantt-with-teams)
* [Configure External Team Management Project](/gantt/guides/resources/external-team-management)

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