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

# Manage Large Datasets with Max Items

> This guide explains how to configure the maximum number of work items loaded into the Nextedy GANTT chart to maintain performance when working with large queries.

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

<Info title="Verify in application">
  This page has thin source coverage. Some behaviors described here are based on code analysis and may vary by version. Verify settings in your application.
</Info>

## Understanding the Max Items Limit

The Gantt widget limits the number of work items loaded from the server to prevent performance degradation with large data sets. When the query returns more items than the configured maximum, excess items are skipped and not displayed on the chart.

The default limit is **100** items.

## Configure Max Items Per Widget

Set the **Max Items** widget parameter on your Gantt widget to control how many items are loaded:

1. Open your Gantt page in **Edit** mode.
2. In the widget parameter sidebar, locate the **Max Items** field.
3. Enter the desired maximum number of items (for example, `200` or `500`).
4. Click **Apply** to save the change.

## Configure the System-Wide Default

Administrators can set the default max items value for all new Gantt widgets using a configuration property in **Administration > Configuration Properties**:

```
nextedy.gantt.workitems.default.max_items=100
```

Once a widget is added to a page, the widget-level parameter value takes precedence over the system default.

## Load Information Indicators

When the Gantt loads data, it tracks several metrics about the loading process:

| Metric           | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| Items            | Total number of work items loaded and displayed              |
| Skipped          | Items that exceeded the max items limit                      |
| Filtered         | Items removed by active filters (time range, resource, etc.) |
| Hidden           | Items hidden due to collapsed parent rows                    |
| Unresolvable     | Items that could not be read (permissions or data issues)    |
| Errors           | Count of items that encountered loading errors               |
| Server load time | Time taken by the server to process the data request         |

The Gantt footer displays the visible row count versus the total (for example, "Gantt Rows: 80 of 120"). If items are skipped due to the max items limit, the funnel icon appears in the footer to alert you.

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DDjWgCW2DWY5biNv/gantt/diagrams/guides/filtering/max-items/diagram-1.svg?fit=max&auto=format&n=DDjWgCW2DWY5biNv&q=85&s=b86acb3165abe4c1bd1ac019e052d024" alt="diagram" style={{ maxWidth: "540px", width: "100%" }} width="540" height="380" data-path="gantt/diagrams/guides/filtering/max-items/diagram-1.svg" />
</Frame>

## Choosing the Right Value

Consider these factors when setting the max items limit:

* **Performance**: Higher values increase page load time and memory usage. Charts with hundreds of items may become slow to render and interact with.
* **Usability**: Very large charts are difficult to navigate visually. Consider using [filters](/gantt/guides/filtering/gantt-filters) or [dynamic queries](/gantt/guides/filtering/dynamic-queries) to narrow the data set instead of increasing the limit.
* **Server load**: Each additional item requires server-side processing for date calculations, resource allocation, and dependency resolution.

<Tip title="Use filters instead of increasing max items">
  Rather than setting a very high max items value, use [page parameters](/gantt/guides/filtering/dynamic-queries) or [Gantt filters](/gantt/guides/filtering/gantt-filters) to narrow the query to a manageable set of work items. This provides better performance and a more focused view.
</Tip>

## Verification

After configuring the max items parameter, you should now see:

* The Gantt chart loading up to the specified number of items.
* The footer row count reflecting the loaded items versus the total query results.
* A funnel icon in the footer if items were skipped due to the max items limit.

## See Also

* [Use Gantt Filters](/gantt/guides/filtering/gantt-filters)
* [Use Dynamic Queries with Page Parameters](/gantt/guides/filtering/dynamic-queries)
* [Troubleshooting Performance Issues](/gantt/guides/troubleshooting/performance)
* [Configure the Toolbar and Menus](/gantt/guides/layout/toolbar-configuration)

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