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.
When a dependency source item is hidden by an item script or cut off by the Max Items limit, save operations may fail silently. This issue was fixed in v25.5.0. If you are on an older version, apply the workarounds below.
- 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:
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.
Open the browser developer tools (right-click > Inspect > Console tab) to see detailed error responses from the server. Save errors include the specific Polarion validation message explaining why the save was rejected.
Permission Issues
Edit and save operations require the user to be a member of the nextedy_gantt_users group. If a user has reviewer-only access (is not in this group), the Gantt opens in read-only mode and save operations are unavailable. 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.
The Gantt warns you about unsaved changes when navigating away. Always save your changes before leaving the page or closing the browser tab. Unsaved changes cannot be recovered after a page refresh.
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_users group
- 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
