New to Telerik UI for Blazor? Start a free 30-day trial

How to Upgrade Telerik UI for Blazor

This article explains how to upgrade to a new version of Telerik UI for Blazor.

To upgrade the Telerik components, you need to update their NuGet package reference, and, if you use them, the CDN links.

The latest available version of UI for Blazor is 9.0.

Before starting an upgrade of your project, you may find it useful to review the following information:

.NET Versions Support - this will let you see what version of the .NET framework you need and which UI for Blazor versions work on it.

UI for Blazor Release History — reviewing the release notes for all releases you go through will let you see what has changed, what fixes, features and components have been implemented so you are better prepared to meet your project's challenges.

Whether you are affected by a breaking change. The List of Telerik UI for Blazor Versions with Breaking Changes article shows which releases of our component suite have breaking changes. Review the information for the releases you go through so you can evaluate whether you will be affected by anything.

In this article:

Upgrade Process
Upgrade with Upgrade Wizard
Upgrade from Trial to Commercial
Troubleshooting

Upgrade Process

To upgrade the Telerik UI for Blazor components used in your project, perform the following steps:

Make sure that you have a NuGet feed source with the version you want to upgrade to. This is usually the Telerik NuGet Feed, but you can also use a local feed from our MSI installer or ZIP archive.
Update your license key if the component version upgrade is related to a license renewal or purchase.
Update the version of the Telerik.UI.for.Blazor NuGet package in all applicable projects.
If you are loading telerik-blazor.js from CDN, update the version number in the CDN URL to match the NuGet package version.
If you are loading themes from CDN, update the version number in the theme URL. For example, if you are upgrading to Telerik UI for Blazor 9.0, the version number in the theme URL must be:
- 11.0.2 if using UNPKG CDN
- 9.0 if using the Telerik CDN
If you are using a local theme stylesheet in wwwroot, then replace it. For example, if the app is using a custom theme, then recreate it with the ThemeBuilder. Or, if the project was created with the Telerik® UI for Blazor Visual Studio Extensions, then download the required built-in theme and add it to the project.
If the application is localized, update the Telerik localization resource (.resx) files. Otherwise, you may see exceptions related to missing localization strings.
Clear the browser cache and optionally add a cache buster for the Telerik CSS and JavaScript files.

Upgrade Wizard

To upgrade the version of Telerik UI for Blazor you can use the Upgrade Wizard that comes as part of the Telerik UI for Blazor Visual Studio Extension.

Upgrade from Trial to Commercial

If you have just purchased a license and you need to migrate from the trial package to the licensed version, perform the following steps:

Update your Telerik license key after you purchase or renew a license.
To upgrade to the latest product version, follow the steps for updating the Telerik UI for ASP.NET MVC version.

Troubleshooting

Microsoft.JSInterop.JSException: Could not find ...

The most common problem you will encounter when upgrading is wrong references to our JS Interop file. You can read more about fixing them in the Troubleshoot JavaScript Errors article.

While using a trial license, a watermark will be rendered over the components and you will see a banner with the following message:

Purchase the Commercial Version now to get access to all product updates and the Telerik expert support.

If you have a commercial license, but you still see the trial watermark and banner, then make sure that:

Your Telerik license key is installed correctly and there are no license key errors during build.
Your Telerik license key is up-to-date.