> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/5/release-notes/overview/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Release notes overview

> Release notes for all Itential Gateway 5.x versions, including feature releases and maintenance releases.

This section contains release notes for all Itential Gateway 5.x versions. Each release page lists the bug fixes, improvements, and security updates included in that version.

## Release types

Itential Platform uses semantic versioning in the format `MAJOR.MINOR.MTCE`:

* **Major releases** introduce breaking changes or significant architectural updates that may require action before upgrading.
* **Minor releases** introduce new capabilities and enhancements. They increment the minor version number (for example, 5.0.0 → 5.1.0 → 5.2.0).
* **Maintenance releases** deliver bug fixes and security patches. They increment the patch version number (for example, 5.0.0 → 5.0.1 → 5.0.2).

## Tags

Each changelog entry is tagged to help you quickly identify what kind of changes the release contains.

| Tag                   | Meaning                                                     |
| --------------------- | ----------------------------------------------------------- |
| `feature-release`     | Introduces new features or significant enhancements         |
| `maintenance-release` | Contains bug fixes, security patches, or minor improvements |
| `bug-fix`             | Includes one or more resolved defects                       |
| `security`            | Includes one or more security fixes                         |
| `breaking-change`     | Contains a change that may require action before upgrading  |
| `gateway`             | Affects Itential Gateway                                    |
| `gateway-manager`     | Affects Gateway Manager                                     |

## Upgrading

Before upgrading, review the release notes for every version between your current version and your target version. Pay particular attention to any releases tagged `breaking-change`.

## Gateway compatibility with Itential Platform

All supported versions of Itential Gateway are tested for compatibility with all supported versions of Itential Platform. New features added in various versions of Gateway might not be available in all versions of Itential Platform because a specific version of the Platform may lack the functionality to make use of that feature.

Refer to the following table to identify the Gateway versions compatible with Itential Platform versions.

| Itential Platform version | Gateway/2022.1 | Gateway/2023.1 | Gateway/2023.2 | Gateway/2023.3 | Gateway/4.3 | Gateway/5.1 | Gateway/5.2 | Gateway/5.3 | Gateway/5.4 |
| ------------------------- | -------------- | -------------- | -------------- | -------------- | ----------- | ----------- | ----------- | ----------- | ----------- |
| Itential Cloud            | Yes            | Yes            | Yes            | Yes            | Yes         | Yes         | Yes         | Yes         | Yes         |
| Platform 6                | Yes            | Yes            | Yes            | Yes            | Yes         | Yes         | Yes         | Yes         | Yes         |
| 2023.2                    | Yes            | Yes            | Yes            | Yes            | Yes         | Yes         | Yes         | Yes         | No          |
| 2023.1                    | Yes            | Yes            | Yes            | Yes            | Yes         | No          | No          | No          | No          |
| 2022.1                    | Yes            | Yes            | Yes            | Yes            | Yes         | No          | No          | No          | No          |

If a version of Itential Platform does not provide support for a feature in a version of Gateway, the versions remain compatible, but Itential Platform will not be able to use that feature in Gateway.

> Release notes for all Itential Gateway 5.x versions, including feature releases and maintenance releases.