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

# Troubleshooting Blank or Non-Loading Gantt

> This guide helps you diagnose and resolve situations where the Nextedy GANTT chart appears blank, shows a permanent loading spinner, or fails to display work items.

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

## Diagnostic Checklist

Work through the following checks in order to identify the root cause:

| Check                  | How to Verify                            | Common Fix                               |
| ---------------------- | ---------------------------------------- | ---------------------------------------- |
| Browser console errors | Right-click > Inspect > Console tab      | Fix reported errors                      |
| Gantt footer messages  | Look for triangle warning icon in footer | Address configuration warnings           |
| Item count in footer   | Check "Gantt Rows: N" display            | Increase Max Items if items were skipped |
| Gantt version          | Check version in footer                  | Update to latest version                 |
| Widget parameters      | Open widget configuration                | Verify dataset and field mappings        |

## Check 1: Review Browser Console for Errors

Open the browser developer tools (right-click > Inspect > Console tab) and look for error messages. Common errors include:

* **Script execution errors** -- Item scripts or config scripts contain syntax errors
* **Network errors** -- API calls to the Gantt data endpoint are failing
* **Authentication errors** -- Session has expired or user lacks permissions

<Tip title="Capture console output for support">
  When contacting support, copy the full browser console output along with your widget parameter configuration. This significantly speeds up diagnosis.
</Tip>

## Check 2: Verify the Gantt Footer

The Gantt footer displays diagnostic information including:

* **Gantt Rows** -- The number of items loaded
* **Error indicator** -- A triangle icon with a count badge when errors are present
* **Skipped items warning** -- Appears when items exceed the Max Items limit

Click the error indicator to see detailed error messages.

## Check 3: Increase Max Items for Large Projects

If your project has more than the default item limit, the Gantt may appear blank because all items were skipped. Check the footer for a skipped items count.

To increase the limit, go to **Widget Parameters > Max Items** and set a higher value.

<Warning title="Projects with 5000+ items may appear blank">
  Very large projects can exceed the default item limit, causing the Gantt to appear empty. Increase the **Max Items** widget parameter incrementally (e.g., to 2000, then 5000) and monitor loading performance. Extremely high values may cause slow loading.
</Warning>

## Check 4: Update to the Latest Gantt Version

Intermittent blank display issues were fixed in several Gantt releases. If you are running an older version:

1. Check the current version in the Gantt footer
2. Update to the latest version following the [Update to the Latest Version](/gantt/getting-started/update-gantt) guide

<Tip title="Version 24.5.2+ fixes intermittent blank display">
  An issue where the Gantt chart intermittently failed to display, particularly related to script execution, was fixed in version 24.5.2. If you experience intermittent blank charts, updating is the recommended first step.
</Tip>

## Check 5: Review Custom Scripts

Custom item scripts, config scripts, or marker scripts can prevent the Gantt from rendering if they contain errors. The Gantt displays an error indicator in the footer when scripts fail.

To test whether a script is causing the issue:

1. Open the widget parameters in the page editor
2. Temporarily clear the **Item Script**, **Gantt Config Script**, and **Markers Script** fields
3. Save and reload the page
4. If the Gantt loads, re-add scripts one at a time to isolate the problem

## Check 6: Verify Configuration Properties

Ensure the widget parameters reference valid Polarion configuration values:

* **Data Mapping fields** (Start Field, End Field, Duration Field) must match actual work item custom field IDs
* **Dependency Role** must reference a valid link role configured in Polarion
* **Work Item Types** must match types defined in the project

The Gantt runs validation at startup and displays diagnostic messages for detected configuration issues.

## Verify

After addressing the identified issue, reload the Gantt chart page. You should now see work items displayed as task bars on the timeline, with the footer showing the correct item count and no error indicators.

## See also

* [Troubleshooting Installation Issues](/gantt/guides/troubleshooting/installation-issues)
* [Troubleshooting Script Errors](/gantt/guides/troubleshooting/script-errors)
* [Troubleshooting Performance Issues](/gantt/guides/troubleshooting/performance)
* [Manage Large Datasets with Max Items](/gantt/guides/filtering/max-items)

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