---
type: explanation
title: Versioning policy
metaTitle: Versioning policy - JavaScript Data Grid | Handsontable
description: Handsontable follows the principles of Semantic Versioning (SemVer). Each version is numbered in the X.Y.Z (Major.Minor.Patch) format.
permalink: /versioning-policy
canonicalUrl: /versioning-policy
react:
  metaTitle: Versioning policy - React Data Grid | Handsontable
angular:
  metaTitle: Versioning policy - Angular Data Grid | Handsontable
vue:
  metaTitle: Versioning policy - Vue Data Grid | Handsontable
searchCategory: Guides
category: Upgrade and migration
---
Handsontable follows the principles of [Semantic Versioning](https://semver.org/) (SemVer).

[[toc]]

## Overview

We use the version format of X.Y.Z (Major.Minor.Patch), incrementing them when a certain type of change occurs to the code.

The following table outlines which number would change when a Major, Minor, or Patch release occurs:

| Type  | Version number | Description                                                                                                                               |
| ----- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Major | X (X.y.z)      | Any backward-incompatible changes are introduced to the public API.                                                                       |
| Minor | Y (x.Y.z)      | New backward-compatible functionality is introduced to the public API, or if any public API functionality is marked as deprecated.        |
| Patch | Z (x.y.Z)      | Backward-compatible bug fixes are introduced. We define a bug fix as an internal change that fixes an incorrect behavior of Handsontable. |

::: only-for javascript

## Versioning of framework variants

Up to Handsontable 8.3.2, each framework variant of Handsontable was versioned separately:

<div class="boxes-list gray">

- [Vanilla JavaScript](@/guides/getting-started/introduction/introduction.md)
- [React wrapper](@/react/guides/getting-started/introduction/introduction.md)
- [Angular wrapper](@/angular/guides/getting-started/introduction/introduction.md)
- [Vue 3 wrapper](@/vue/guides/getting-started/installation/installation.md)


</div>
Starting with version 8.4.0 (released in May 2021), all framework variants of Handsontable have the same version number.

:::

::: only-for react

## Versioning of framework variants

Up to Handsontable 8.3.2, the JavaScript variant and the React variant of Handsontable were versioned separately:
- [Vanilla JavaScript](@/javascript/guides/getting-started/introduction/introduction.md)
- [React wrapper](@/guides/getting-started/introduction/introduction.md)

Starting with version 8.4.0 (released in May 2021), both the JavaScript variant and the React variant of Handsontable have the same version number.

:::
