> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/4/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  4.3, 2023.3, and 2023.2 versions, including feature releases and maintenance releases.

This section contains release notes for Itential Gateway versions 4.3, 2023.3, and 2023.2. Each changelog entry lists the bug fixes, improvements, and security updates included in that version.

## Gateway versioning practices

All supported versions of Gateway are assigned unique identifiers (version numbers) to help manage different versions and releases of the software to ensure customers can access the correct version they need.

Here's an explanation of how Itential names Gateway versions to help you understand the nature of changes between versions:

* **Component version** — This identifies the build version of the Platform application (i.e., Gateway) distributed in a maintenance release. For each change made to the source code as part of a development build, whether it's a bug fix or improvement, there is a `component` version bump. Components are versioned independently of product release versions. Also, multiple builds can be created for a single **release version**.

* **Release version** — This identifies the Platform release version of Gateway made available to customers in a maintenance release. Release versioning helps to track different iterations of the software and increments each month as part of the maintenance release.

Each versioning scheme is purposely designed to provide a structured mechanism of releasing and tracking Itential's product versions, enabling developers to identify bugs more efficiently and maintain code integrity.

If you need additional support or require more information about Itential's versioning, contact our [Product Support Team](https://itential.atlassian.net/servicedesk/customer/portals).

### Release types

As of Gateway 4.3, Itential 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, 4.3.0 → 4.4.0 → 4.5.0).
* **Maintenance releases** deliver bug fixes and security patches. They increment the patch version number (for example, 4.3.0 → 4.3.1 → 4.3.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/4.3`         | Affects Gateway version 4.3                                 |
| `gateway/2023.3`      | Affects Gateway version 2023.3                              |
| `gateway/2023.2`      | Affects Gateway version 2023.2                              |

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

> **Info**
>
> 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 4.3, 2023.3, and 2023.2 versions, including feature releases and maintenance releases.