> ## 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 Save Failures

> This guide helps you diagnose and fix situations where changes made in the Nextedy GANTT chart fail to save to Polarion.

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

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

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/guides/troubleshooting/save-failures/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=fdea887210aab4fe74923c672ad34470" alt="diagram" style={{ maxWidth: "900px", width: "100%" }} width="900" height="200" data-path="gantt/diagrams/guides/troubleshooting/save-failures/diagram-1.svg" />
</Frame>

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

<Warning title="Hidden items can cause data loss">
  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.
</Warning>

**Workaround:**

1. Increase the **Max Items** widget parameter to a higher value (e.g., `10000`) to ensure all dependency-related items are loaded
2. Review your item scripts and remove any logic that hides items that are dependency sources
3. 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.

<Tip title="Check browser console for details">
  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.
</Tip>

### 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](/gantt/guides/troubleshooting/reviewer-access) 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.

<Warning title="Save before leaving the page">
  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.
</Warning>

## Diagnostic Steps

1. **Check the Gantt footer** for error indicators (triangle icon with count badge)
2. **Open browser console** (right-click > Inspect > Console) and look for error messages after clicking Save
3. **Verify field mappings** in widget parameters match actual Polarion custom field IDs
4. **Check user permissions** -- ensure the user is in the `nextedy_gantt_users` group
5. **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](/gantt/guides/editing/unsaved-changes)
* [Troubleshooting Reviewer Access Issues](/gantt/guides/troubleshooting/reviewer-access)
* [Manage Large Datasets with Max Items](/gantt/guides/filtering/max-items)
* [Troubleshooting Blank or Non-Loading Gantt](/gantt/guides/troubleshooting/blank-gantt)

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