Release notes overview

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.