New to Kendo UI for Vue? Start a free 30-day trial

Assisted Migration Tooling

Updated on Nov 6, 2026

You can speed up the migration between major Kendo UI for Vue versions with the Kendo CLI. The Kendo CLI is a command-line tool that updates your Kendo UI for Vue packages and runs codemods—automated code transformations—that handle the breaking changes of each major release.

Overview

During the migration, the codemods scan the following files in your project:

.vue single-file components, including their templates, script blocks, and style blocks
.ts, .tsx, .js, and .jsx files
.css, .scss, .sass, and .less stylesheets

The codemods are of two kinds:

Codemods that update your code—for example, they rename or remove props, update import paths, and change prop values.
Instruction-only codemods—they do not modify your code. They flag the files that are affected by a change that cannot be applied automatically, such as a rendering change or a new default behavior, and print instructions on how to migrate them manually.

The --ai-mode option changes how the migration runs:

	Without `--ai-mode`	With `--ai-mode`
Instruction-only codemods	Skipped.	Run, and the Kendo CLI prints the instructions together with the list of the affected files.
Codemods that update your code	The Kendo CLI shows a diff for each changed file and asks you to accept or reject it. With `--force`, it applies the changes without asking.	The Kendo CLI applies the changes directly to your files, without asking you to review them.
Optional codemods	The Kendo CLI asks you whether to run each of them.	Run without asking.
Output	Progress messages for each codemod.	A report that lists the packages with changes, the flagged files with their instructions, and the packages that required no changes.

All Kendo UI for Vue 11.0.0 codemods are instruction-only, so you need the --ai-mode option to see the instructions for the affected files. Because --ai-mode applies the code-updating codemods without a review, commit your work before you run it and review the changes in source control afterwards.

The --ai-mode option requires Kendo CLI 1.17.0 or later.

Dynamic template bindings (v-bind="obj", :[name]), lang="pug" templates, and components registered globally with app.component() are not analyzed. Review them manually.

To migrate your project, follow these steps:

Commit or back up your current work so that you can review the changes that the migration makes.
Install the Kendo CLI globally.
bash
```
npm i -g @progress/kendo-cli
```
In the root of your project, run the migration for the package and the versions that you migrate between.
bash
```
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10 --to=11 --ai-mode
```
The command checks for an available update of the package, including the @progress peer dependencies that are already present in the project, and lists the packages that it will update.
Confirm that you want to install the available updates.

The Kendo CLI installs the new versions and runs the codemods for the versions from --from up to the installed version.
Read the printed report. For each flagged codemod, the report contains the migration instructions and the list of the affected files.
Apply the described changes to the flagged files.
Run your project and its tests to verify that everything works as expected.

The --ai-mode option applies the code-updating codemods without asking for a review. Do not run the migration without --ai-mode first to review and reject changes and then run it again with --ai-mode—the second run applies again the changes that you rejected. Instead, commit your work before the run and review or revert the applied changes with your source control.

For the list of changes that each release introduces, see the Breaking Changes and Rendering Changes articles.

Best Practices

For a more manageable migration process, consider the following recommended practices:

Migrate between consecutive major versions—for example, migrate from v10 to v11. This lets you review and adjust your code version by version and avoid possible conflicts between breaking changes.
Always set --from. Without it, the Kendo CLI runs the codemods of every version up to the installed one, and the instructions for old migrations that you have already completed can be reported again.
Migrate one package at a time. This provides finer control over the migration and makes it easier to monitor the changes.
Review the changes in source control after each run, and run your tests before you move to the next package or version.

CLI Quick Guide

The following list describes the most common migration scenarios.

Specify the package to migrate and the version to migrate from. Commands without a package process every installed Kendo UI package that has an available update.
Once the Kendo CLI is installed, you can run the commands with the kendo handle instead of npx @progress/kendo-cli. For example, kendo migrate.

bash

# Install the Kendo CLI globally.
npm i -g @progress/kendo-cli

# Run a guided migration for all packages that have an update. You will be prompted every step of the way.
npx @progress/kendo-cli migrate --from=10

# Migrate a specific package and print the instructions of the instruction-only codemods.
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10 --ai-mode

# Migrate a specific package between particular versions.
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10 --to=11 --ai-mode

# Run a quick migration without any confirmations.
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10 --force

# Only install the available updates. Do not run any codemods.
# Useful when you want to migrate your code manually.
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --no-codemods

# Only run the codemods. Do not install any packages.
# Useful when you have already updated the packages.
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10 --no-install --ai-mode

# Run the codemods for all installed Kendo UI packages. Do not install any packages.
npx @progress/kendo-cli migrate --from=10 --no-install --ai-mode

# Ignore specific files or directories during the migration.
npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10 --no-install --ai-mode --ignore-pattern="dist/**"

To use the --to option, specify exactly one package in the command. Without a package, or with more than one package, the Kendo CLI updates the packages to their latest versions.

With --no-install, the Kendo CLI runs the codemods only for the packages that you specify. To run them for every installed Kendo UI package without listing them, add --ai-mode.

CLI Arguments

To control the migration, use any of the following arguments when you run kendo migrate.

Argument	Description	Sample Use
`<pkg>`	Specifies one or more packages for which to run the migration. If not set, runs for all Kendo UI packages in the project.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid`
`--help`	Prints the help for the command.	`npx @progress/kendo-cli migrate --help`
`--version`	Prints the version of the Kendo CLI.	`npx @progress/kendo-cli --version`
`--verbose`, `-v`	Sets the verbosity level of the command output from `1` (default) to `5` (most verbose). Repeat the option to increase the level.	`npx @progress/kendo-cli migrate -vvv`
`--quiet`, `-q`	Silences the output as much as possible. Sets the verbosity level to `0`.	`npx @progress/kendo-cli migrate --quiet`
`--force`, `-f`	Runs in force mode and does not ask for confirmations, including the confirmation to install the updates.	`npx @progress/kendo-cli migrate --force`
`--to`	Specifies the package version to migrate to. If not set, migrates to the latest available version. Applies only when you specify exactly one package.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid --to=11`
`--from`	Specifies the version to migrate from. The Kendo CLI runs the codemods for the versions from this one up to the installed version. If not set, it runs the codemods of all versions up to the installed one.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid --from=10`
`--ai-mode`	Runs the instruction-only codemods and prints their instructions with the affected files. Also runs the optional codemods without asking and applies the code-updating codemods without a review. Requires Kendo CLI 1.17.0 or later.	`npx @progress/kendo-cli migrate --ai-mode`
`--no-install`	Skips the installation part of the migration. Use it when you have already updated your packages and want to only run the codemods. Specify the packages, or add `--ai-mode` to process every installed Kendo UI package.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid --no-install`
`--no-codemods`	Skips the codemods step of the migration. Use it to only install the available updates.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid --no-codemods`
`--no-peer-deps`	Skips the update of the `@progress` peer dependencies of the specified packages that are already installed in the project. By default, the Kendo CLI also updates them.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid --no-peer-deps`
`--no-optional`	Skips the optional codemods, if any. Has no effect together with `--ai-mode`, which always runs them.	`npx @progress/kendo-cli migrate @progress/kendo-vue-grid --no-optional`
`--ignore-pattern`	Specifies a single glob pattern, relative to the project root, of files or directories to exclude from the migration. The `node_modules` folder is always excluded.	`npx @progress/kendo-cli migrate --ignore-pattern="dist/**"`

For the full list of Kendo CLI commands, see Kendo CLI Options.

Available Codemods

The codemods are designed to handle the breaking changes that each major release introduces. The following table lists the packages that have codemods for each migration path. For the codemods of each package and what they detect, see Available Codemods.

Migration Path	Packages with Codemods
From v10.0.0 to v11.0.0	Grid, Layout, Scheduler
From v9.0.0 to v10.0.0	Scheduler
From v8.0.0 to v9.0.0	Buttons, Common, Conversational UI, Data Tools, Date Inputs, Dialogs, Dropdowns, Grid, Indicators, Inputs, Layout, ListBox, Notification, Popup, Scheduler, TreeList
From v7.0.0 to v8.0.0	Buttons, Data Tools, Date Inputs, Dropdowns, Grid, Indicators, Inputs, Layout, ListBox, TreeList