Skip to main content
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.

​
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:
MetricDescription
ItemsTotal number of work items loaded and displayed
SkippedItems that exceeded the max items limit
FilteredItems removed by active filters (time range, resource, etc.)
HiddenItems hidden due to collapsed parent rows
UnresolvableItems that could not be read (permissions or data issues)
ErrorsCount of items that encountered loading errors
Server load timeTime taken by the server to process the data request
The Gantt footer displays the visible row count versus the total (for example, “Rows: 80 of 120”). If items are skipped due to the max items limit, the funnel icon appears in the footer to alert you. diagram

​
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 or 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.
Rather than setting a very high max items value, use page parameters or Gantt filters to narrow the query to a manageable set of work items. This provides better performance and a more focused view.

​
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

Source Code
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/Config.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/WorkItemsGanttWidget.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/LoadInfo.java