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
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
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.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:- Check the current version in the Gantt footer
- Update to the latest version following the Update to the Latest Version guide
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:- Open the widget parameters in the page editor
- Temporarily clear the Item Script, Gantt Config Script, and Markers Script fields
- Save and reload the page
- 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
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
- Troubleshooting Script Errors
- Troubleshooting Performance Issues
- Manage Large Datasets with Max Items
Sources
Sources
KB ArticlesSupport TicketsSource Code
prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/gantt-scripts/dependencyItemIsHidden.cy.tsprod-gantt-src/com.nextedy.polarion.gantt.client/src/js/diagnosis.jsprod-gantt-src/com.nextedy.polarion.gantt.client/src/js/functions.jsprod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/Aresource-view/ganttMarkersColorConfigValidation.cy.tsprod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/ganttWorkOnDefaultScope.cy.ts