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

# Polarion Version Compatibility Matrix

> Nextedy GANTT is a server extension for Siemens Polarion ALM. This page documents version compatibility between Gantt releases and Polarion versions, including known migration requirements.

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

<Info title="Verify in application">
  Always verify compatibility with your specific Polarion and Gantt versions before upgrading in production. Contact Nextedy support for the latest compatibility information.
</Info>

## Compatibility Overview

| Polarion Version | Minimum Gantt Version | Notes                                            |
| ---------------- | --------------------- | ------------------------------------------------ |
| Polarion 2310    | 24.6.0                | Fully compatible; update Gantt to latest version |
| Polarion 2404    | See application       | Compatible with latest Gantt versions            |
| Polarion 2506    | 25.9.0                | Compatibility issues fixed in v25.9.0            |

<Warning title="Upgrade Requirement">
  When upgrading Polarion, always update to the latest Gantt version to ensure full compatibility. Older Gantt versions may not function correctly with newer Polarion releases.
</Warning>

## Scripting API Changes (Polarion 2304+)

Starting with Polarion 2304, changes to the Polarion scripting environment require script migration for Gantt page scripts and config scripts.

| Change                   | Impact                                                    | Action Required                                                     |
| ------------------------ | --------------------------------------------------------- | ------------------------------------------------------------------- |
| Scripting API changes    | Existing page scripts and config scripts may stop working | Review and update custom scripts after Polarion upgrade             |
| Script execution context | Modified execution environment for Velocity scripts       | Test all scripts in a staging environment before production upgrade |

<Tip title="Test Before Upgrading">
  Use a test license to validate your Gantt configuration and scripts against the new Polarion version before applying the upgrade to production. See [License Types and Evaluation Periods](/gantt/reference/license-types) for test license information.
</Tip>

## Upgrade Workflow

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/reference/compatibility-matrix/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=29b7a1730caf242d0516401666b6b4cc" alt="diagram" style={{ maxWidth: "620px", width: "100%" }} width="620" height="520" data-path="gantt/diagrams/reference/compatibility-matrix/diagram-1.svg" />
</Frame>

## Known Compatibility Issues

### Polarion 2506

| Issue                     | Symptom                                 | Resolution                       |
| ------------------------- | --------------------------------------- | -------------------------------- |
| Workflow field regression | Log file errors after upgrade           | Fixed in Gantt v25.9.0           |
| Log errors                | Server log errors after Polarion update | Update Gantt to v25.9.0 or later |

### Polarion 2310

| Issue                 | Symptom                            | Resolution                                              |
| --------------------- | ---------------------------------- | ------------------------------------------------------- |
| Older Gantt versions  | Scripts stop working after upgrade | Update Gantt to v24.6.0 or later                        |
| Scripting API changes | Custom scripts fail to execute     | Migrate scripts to updated API (Polarion 2304+ changes) |

## Version Identification

You can identify the installed Gantt version from the Gantt footer. The version number is displayed in the bottom-right corner of the Gantt chart widget.

| Location     | Description                                                                          |
| ------------ | ------------------------------------------------------------------------------------ |
| Gantt footer | Version string (e.g. `25.9.0`) displayed at the bottom of the widget                 |
| Admin page   | Navigate to `/polarion/#/administration/gantt/setup` for version and license details |

## Pre-Upgrade Checklist

| Step | Action                                                                               |
| ---- | ------------------------------------------------------------------------------------ |
| 1    | Verify target Polarion version compatibility with current Gantt version              |
| 2    | Download the latest Gantt version from Nextedy                                       |
| 3    | Install Gantt update in a staging environment                                        |
| 4    | Test all custom scripts (config scripts, item scripts, page scripts, marker scripts) |
| 5    | Verify working calendar calculations                                                 |
| 6    | Validate dependency link behavior                                                    |
| 7    | Confirm resource view accuracy                                                       |
| 8    | Apply to production                                                                  |

## Workflow Condition Compatibility

The Gantt provides a workflow condition that integrates with Polarion workflow enforcement. This condition is dependency-type-aware:

| Feature                      | Description                                                                                                       |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Status gate enforcement      | Prevents work item transitions unless linked predecessors are in allowed states                                   |
| Dependency-type filtering    | Only Finish-to-Start dependencies are enforced in forward checks; Start-to-Start and Start-to-Finish are excluded |
| Cross-permission enforcement | Dependency gates are enforced even when linked items are not visible to the current user                          |

<Note title="Workflow Condition Parameters">
  Configure the workflow condition in Polarion's workflow XML with these parameters: `link.roles` (forward link roles), `back.link.roles` (reverse link roles), and `valid.states` (allowed status IDs). See [General Administration Properties](/gantt/reference/configuration/general-properties).
</Note>

## Configuration Example

Verify the installed Gantt version by checking the footer or navigating to the admin page:

```
https://your-polarion.example.com/polarion/#/administration/gantt/setup
```

## Related Pages

* [Install Gantt](/gantt/getting-started/installation) -- installation and update instructions
* [Update to the Latest Version](/gantt/getting-started/update-gantt) -- step-by-step update tutorial
* [License Types and Evaluation Periods](/gantt/reference/license-types) -- test license for upgrade validation
* [Error Messages and Diagnostics](/gantt/reference/error-messages) -- diagnosing post-upgrade issues

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