# Keeping Up to Date

The Kendo UI for Angular packages are released frequently including bug fixes and new features.

> tip Starting with Kendo UI for Angular v19.0.0, some component packages now provide codemods to help you migrate between major versions. For more details, check out [Migrating Your Code](https://www.telerik.com/kendo-angular-ui/components/assisted-migration). <br/><br/> Check the [currently supported Angular versions](https://www.telerik.com/kendo-angular-ui/components/installation/requirements#angular).

## Semantic Versioning

The Kendo UI for Angular packages are released together (all `@progress/kendo-angular-*` packages have the same version) and their version numbers follow the rules of [Semantic Versioning](https://docs.npmjs.com/about-semantic-versioning):

* A major version bump (X.y.z) signals a breaking change in the API. You might need to update application code or dependencies.
* A minor version bump (x.Y.z) signals the addition of new features. Existing code will continue to work but new features may require additional setup.
* A patch version bump (x.y.Z) indicates a bug-fix release. Typically, patches do not require changes to application code.

To see the list of changes for each release, see the detailed [changelog](https://www.telerik.com/kendo-angular-ui/components/changelogs/kendo-angular-ui).

> Prior to version 11, the `@progress/kendo-angular-<package-name>` packages used independent versioning and shipped individual changelogs.
> See <https://github.com/telerik/kendo-angular/issues/3859> for details about this change.

## Updating to Compatible Releases

To allow updating to Minor and Patch releases, the `package.json` file must references a major version range—for example, `"@progress/kendo-angular-grid": "^3.0.0"`.

> All `@progress/kendo-angular-<package-name>` packages must have the same version reference.

To fetch the latest compatible Minor or Patch release, run `npm update`.

> Commit the updated `package-lock.json` file in the source control.

## Updating to Latest Versions

To update to the most recent versions of the Kendo UI for Angular components, use [`npm-check-updates`](https://www.npmjs.com/package/npm-check-updates).

* To upgrade all Progress packages, run:

  ```sh
  npx npm-check-updates --upgrade --filter "/@progress.*/"
  ```

* To upgrade only Kendo UI for Angular packages, run:

  ```sh
  npx npm-check-updates --upgrade --filter "/@progress/kendo-angular.*/"
  ```

* In some cases, you may have to specify the location of the `package.json` file:

  ```sh
  npx npm-check-updates --upgrade --filter "/@progress.*/" --packageFile ./package.json
  ```

A successful run will record the updated versions in `package.json` and `package-lock.json`.

> Upgrading between major versions might require you to change the application code.
>
> For more details, refer to the [Changelogs](https://www.telerik.com/kendo-angular-ui/components/changelogs/kendo-angular-ui) and [Rendering Changes](https://www.telerik.com/kendo-angular-ui/components/changelogs/rendering-changes) documentation.

## Updating to Unsupported Releases

The latest package versions are compatible with [Active and LTS](https://angular.dev/reference/releases#actively-supported-versions) Angular versions. For legacy Angular versions, use distribution tags (e.g. `ng10`) to install compatible Kendo UI for Angular components.

Distribution tags are available from Angular v2 to Angular v18.

> Apply the distribution tag to all packages to obtain the correct versions.

To update to the latest Buttons package version compatible with Angular v10.x, run.

```sh
npm install --save @progress/kendo-angular-buttons@ng10
```

To add a package to an existing Angular 10.x project, use `ng add` command.

```sh
ng add @progress/kendo-angular-buttons@ng10
```

## Updating Angular

To generate checklists for upgrading between framework versions, use the [Angular Upgrade Guide](https://angular.dev/update-guide).

## Suggested Links

* [All Things Angular Telerik Blog Page](https://www.telerik.com/blogs/all-things-angular)
* [Using Kendo UI for Angular with Angular CLI](https://www.telerik.com/kendo-angular-ui/components/installation/angular-cli)