How Saving Works
When you click the Save button, the Gantt sends all pending task and link changes to the Polarion server. A progress spinner appears during the save operation. If there are no unsaved changes, the save button does nothing. The Gantt tracks unsaved changes across all tasks. Modified tasks are visually marked to indicate they have pending changes. The Save button state reflects whether any unsaved changes exist.Common Causes and Solutions
Hidden Dependency Items
The most common cause of save failures is when dependency source items are hidden from the Gantt view, either by item scripts or by exceeding the Max Items limit. Workaround:- Increase the Max Items widget parameter to a higher value (e.g.,
10000) to ensure all dependency-related items are loaded - Review your item scripts and remove any logic that hides items that are dependency sources
- Update to Gantt v25.5.0 or later, which resolves this issue
Missing or Invalid Field Configuration
Save failures occur when the configured data mapping fields do not match valid Polarion work item fields:| Field | Widget Parameter | Check |
|---|---|---|
| Start date | Start Field | Must be a valid date custom field |
| End date | End Field | Must be a valid date custom field |
| Duration | Duration Field | Must be a valid numeric custom field |
| Progress | Progress Field | Must be a valid float custom field |
| Resource | Resource Field | Must be a valid field or assignee |
Workflow Validation Errors
Polarion workflow rules may reject changes if required fields are missing or if the current work item state does not allow modifications. Check the browser console for specific error messages from the Polarion server.Permission Issues
The Gantt requires the Polarionuser role for all API operations. If a user has reviewer-only access, save operations will fail. See Troubleshooting Reviewer Access Issues for resolution steps.
Session Timeout
Long editing sessions can cause the Polarion session to expire. The Gantt includes a keep-alive mechanism to prevent this, but network interruptions may still cause session loss. If saves fail after a long session, refresh the page to re-establish the session.Diagnostic Steps
- Check the Gantt footer for error indicators (triangle icon with count badge)
- Open browser console (right-click > Inspect > Console) and look for error messages after clicking Save
- Verify field mappings in widget parameters match actual Polarion custom field IDs
- Check user permissions — ensure the user is in the
nextedy_gantt_usersgroup - Test with a simple edit — try dragging a single task and saving to isolate the issue
Verify
After addressing the identified issue, make a small change (drag a task bar to a new date) and click Save. You should now see the progress spinner complete without errors, and the task’s modified indicator should clear. Refresh the page to confirm the change persisted.See also
- Handle Unsaved Changes and Session Timeout
- Troubleshooting Reviewer Access Issues
- Manage Large Datasets with Max Items
- Troubleshooting Blank or Non-Loading Gantt
Sources
Sources
Support TicketsSource Code
prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/LoadInfo.javaprod-gantt-src/com.nextedy.polarion.gantt.client/src/js/functions.jsprod-gantt-src/com.nextedy.polarion.gantt.client/src/js/commands.jsprod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/Rewritten Tests/testGanttCreatePlan.cy.tsprod-gantt-src/com.nextedy.polarion.gantt.client/src/js/nextedy.js