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

# Use Gantt Filters

> This guide shows you how to apply item, resource, time range, and allocation filters in Nextedy GANTT to focus the chart on the work items that matter most.

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

## Filter Types Overview

| Filter Type                 | Trigger                                    | Available Since |
| --------------------------- | ------------------------------------------ | --------------- |
| Time range                  | Gantt Config Script                        | All versions    |
| Filter by item              | Select items, then click toolbar button    | 25.4.1          |
| Filter by resource          | Click a resource name in the resource view | 25.4.1          |
| Filter by allocation bubble | Click an allocation marker cell            | 25.4.1          |

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DW7SPQWol8VdzZS9/gantt/images/48001271331/1.png?fit=max&auto=format&n=DW7SPQWol8VdzZS9&q=85&s=1ae620566f1aedf52c4d6b4f6bc8b4bc" alt="Gantt chart with the toolbar filter buttons for filtering by item, resource, and allocation introduced in version 25.4.1" width="1946" height="1239" data-path="gantt/images/48001271331/1.png" />
</Frame>

When any filter is active, a **funnel icon** appears in the Gantt footer. Hover over the funnel icon to see a tooltip describing the currently applied filter (time range, by item, resource, or allocation).

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DW7SPQWol8VdzZS9/gantt/images/48001271331/2.png?fit=max&auto=format&n=DW7SPQWol8VdzZS9&q=85&s=f7d59958565d9964ae0a06e8e4cd7710" alt="Funnel icon in the Gantt footer with a tooltip describing the currently applied filter" width="944" height="156" data-path="gantt/images/48001271331/2.png" />
</Frame>

## Filter by Time Range

Set a fixed time range in **Advanced > Gantt Config Script** to limit which work items are visible on the chart:

```javascript theme={null}
gantt.config.start_date = new Date(2024, 11, 10);
gantt.config.end_date = new Date(2025, 7, 20);
```

<Warning title="JavaScript months are zero-based">
  In JavaScript `Date` objects, months start at 0 (January = 0, December = 11). The example above sets the range from **10 December 2024** to **20 August 2025**.
</Warning>

### Use Page Parameters for Dynamic Time Ranges

To let users select the time range interactively, create `start` and `end` page parameters on your LiveReport page, then reference them in the Gantt Config Script:

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DW7SPQWol8VdzZS9/gantt/images/48001271331/3.png?fit=max&auto=format&n=DW7SPQWol8VdzZS9&q=85&s=5399bd473f56289f28d5564f89e1f1c9" alt="LiveReport page with start and end page parameters configured to drive the Gantt time range" width="894" height="458" data-path="gantt/images/48001271331/3.png" />
</Frame>

```javascript theme={null}
gantt.config.start_date = new Date($widgetContext.pageParameters.start.value.time);
gantt.config.end_date = new Date($widgetContext.pageParameters.end.value.time);
```

Replace `start` and `end` with the IDs of your page parameters if you named them differently. See [Use Dynamic Queries with Page Parameters](/gantt/guides/filtering/dynamic-queries) for more details.

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DW7SPQWol8VdzZS9/gantt/images/48001271331/4.gif?s=8b894338d0edd4ba6660b181deae2f6f" alt="Animation showing the Gantt time range updating live as the start and end page parameters are changed" width="1496" height="586" data-path="gantt/images/48001271331/4.gif" />
</Frame>

## Filter by Item

1. Click one or more work items in the Gantt chart to select them.
2. Click the **Filter by Item** button in the toolbar.
3. The chart displays only the selected items and their related items (parents, children, and dependencies).

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DW7SPQWol8VdzZS9/gantt/images/48001271331/5.gif?s=a1d27d6158ba49151d804e4baa025c89" alt="Animation of selecting work items and clicking Filter by Item, leaving only the selected items and their related items visible" width="1278" height="632" data-path="gantt/images/48001271331/5.gif" />
</Frame>

To clear the filter, click the **Filter by Item** toolbar button again to toggle it off.

## Filter by Resource

Click on a specific resource (assignee) name in the resource view to filter the chart to only rows where that resource is assigned. This helps you focus on an individual team member's workload.

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/E5md2k2_IvgOAoTX/gantt/images/48001271331/6.gif?s=1b02a0d4ebe192cb0419ba2215fc1425" alt="Animation of clicking a resource name in the resource view to show only rows where that assignee is assigned" width="1278" height="632" data-path="gantt/images/48001271331/6.gif" />
</Frame>

<Tip title="Resource filtering preserves context">
  When filtering by resource, parent and dependent tasks remain visible to maintain the scheduling context. The filtered resource's tasks are highlighted while related items stay accessible.

  <Frame>
    <img src="https://mintcdn.com/none-17b4493f/E5md2k2_IvgOAoTX/gantt/images/48001271331/7.png?fit=max&auto=format&n=E5md2k2_IvgOAoTX&q=85&s=e39ef09e2cec3487afc3d5ac5e3ce493" alt="Blue stripe highlight extended to child items sharing the same assignee, with parent and dependent tasks still visible for context" width="934" height="1096" data-path="gantt/images/48001271331/7.png" />
  </Frame>
</Tip>

## Filter by Allocation Bubble

Click an allocation bubble (marker cell) in the resource view to filter by a specific resource within a specific time period. This shows which work items contribute to that resource's workload in the selected day, week, or month.

When the **Resource Load Calculation** is set to **Remaining Estimate** or **Estimate + Spent**, a workload column appears in the table view showing the planned effort (in hours) per task. Since version 25.4.2, filtering by allocation bubble works with all load calculation modes, but the per-task effort column only appears for estimate-based modes.

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/E5md2k2_IvgOAoTX/gantt/images/48001271331/8.gif?s=a927970755e4cfbf52a4723caca3ef43" alt="Animation of filtering by an allocation bubble, revealing a table column with the planned effort in hours for each contributing item" width="986" height="624" data-path="gantt/images/48001271331/8.gif" />
</Frame>

<Note title="Collapsed trees expand automatically">
  When you filter by allocation bubble, any collapsed parent items automatically expand so you can see all affected items and their allocations.

  <Frame>
    <img src="https://mintcdn.com/none-17b4493f/E5md2k2_IvgOAoTX/gantt/images/48001271331/9.png?fit=max&auto=format&n=E5md2k2_IvgOAoTX&q=85&s=4615dd0f20b667749c377d0240dfc783" alt="Previously collapsed parent trees automatically expanded after filtering by an allocation bubble, showing all affected items and their allocations" width="1596" height="1248" data-path="gantt/images/48001271331/9.png" />
  </Frame>
</Note>

## Footer Indicators

The Gantt footer shows the number of visible rows versus the total (for example, "Gantt Rows: 4 of 10"). When items are hidden by a filter or by collapsed parent rows, the funnel icon appears. Hover over it to see which filter is active and why items are hidden.

## Verification

After applying a filter, you should now see:

* The funnel icon in the footer indicating an active filter.
* Only the matching work items visible in the chart.
* The footer row count reflecting the filtered set (for example, "Gantt Rows: 4 of 10").
* Hovering over the funnel icon displays a tooltip describing the active filter.

## See Also

* [Filter by Resource and Allocation](/gantt/guides/filtering/filter-by-resource)
* [Set the Gantt Time Range](/gantt/guides/scheduling/set-time-range)
* [Use Dynamic Queries with Page Parameters](/gantt/guides/filtering/dynamic-queries)
* [Configure the Toolbar and Menus](/gantt/guides/layout/toolbar-configuration)
* [Set Up the Resource View](/gantt/guides/resources/resource-view)

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