# License Key Errors

This page provides solutions for license key errors that you may encounter while building UI for ASP.NET MVC apps.

> The deployment articles in this documentation provide general guidance and fundamentals. Telerik does not provide technical support for setting up CI/CD environments or application publishing infrastructure, except for questions about [using Telerik license keys](https://www.telerik.com/aspnet-mvc/documentation/deployment/ci-cd-license-key).

## Basics

A Telerik license key error may occur in the following scenarios:

* Missing license key.
* Using an expired subscription license after the end of the subscription term.
* Using a perpetual license with a product version that was released outside the validity period of your license.
* Using an expired trial license.
* Using an outdated license key after making renewals or purchases.
* Using a license key that doesn't include Telerik UI for ASP.NET MVC.
* Using conflicting license keys in the same environment. For example, using one global license key and one in the app. Or, using a license key file together with an environment variable in CI/CD environment.
* Mismatching versions of the `Kendo.Mvc.dll` and the Kendo UI JavaScript files referenced in the project.

A missing, expired, or invalid license will result in:

* A watermark appearing on application startup.
* A [banner](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/license-key-errors#banner) appearing on pages that use the UI for ASP.NET MVC components.
* A warning message in the build log

Activating a valid license removes the banner and the watermark.

### Banner

The colored accent bar and the action button of the banner reflect the severity of the message. The title, message, and available action vary with the license status. Clicking the action button directs you to start a trial, purchase, or renew a license, depending on the message.

The following example illustrates a client-side missing-license banner for Telerik UI for ASP.NET MVC.

![Missing-license banner for Telerik UI for ASP.NET MVC with a Start Free Trial button](https://www.telerik.com/aspnet-mvc/documentation/assets/6244eaed7aab4f506b10a26206d3a7df/banner-mvc.png)

Clicking the x (**Close**) button closes the banner. For messages that support snoozing, the banner and the related watermark do not reappear on page reload until the snooze period, which is determined by the licensing package, ends. The browser remembers this choice in its `localStorage`, so clearing the site data resets it. Messages that do not support snoozing appear again on the next page load.

### Trial Notices

With a valid trial license, a dismissible notice banner without a watermark may appear on pages that use the components. The banner can display a badge with the remaining trial days, for example, `19d left`.

The following simulated example illustrates a client-side trial notice for Telerik UI for ASP.NET MVC.

![Trial notice for Telerik UI for ASP.NET MVC with a 19d left badge and a See Plans button](https://www.telerik.com/aspnet-mvc/documentation/assets/fa9fd1fc32669ca3b4a15ddfbcab8783/trial-banner-mvc.png)

The message and available action vary with the trial stage. A trial notice does not indicate that license activation has failed.

## Error Messages

### No Telerik or Kendo UI product references detected in project (TKL001)

This error can occur when a project references `Telerik.Licensing`, but not any other Telerik packages. In this case, remove the `Telerik.Licensing` package from the project. If your scenario is different, [contact Technical Support](https://www.telerik.com/account/support-center).

### No Telerik and Kendo UI License file found (TKL002)

The error means that the license key is missing or not set up correctly. For example, the environment variable is not set, or [the license file may be located in the wrong place](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#manual-installation).

In a production application, a missing-license banner may prompt you to start a trial or configure an existing license key.

[Install a license key](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license) again. Also, check how to [set up a license key in CI/CD environments](https://www.telerik.com/aspnet-mvc/documentation/deployment/ci-cd-license-key).

### Corrupted Telerik and Kendo UI License Key content (TKL003)

The license key is detected, but its value is invalid and cannot be decrypted. For example, if you have set a `TELERIK_LICENSE` environment variable through the Windows operating system's UI, then it may be truncated. In such cases, remove the environment variable and use a license key file instead.

Follow the [automatic](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#automatic-installation) or [manual](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#manual-installation) installation steps from scratch. Also, check how to [set up a license key in CI/CD environments](https://www.telerik.com/aspnet-mvc/documentation/deployment/ci-cd-license-key).

### Unable to locate licenses for all products (TKL004)

Your license is not valid for the detected product(s), because it doesn't include them.

[Review the purchase options for Telerik UI for ASP.NET MVC](https://www.telerik.com/purchase/aspnet-mvc). If you have already purchased the required license, then [update your license key](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#license-key-updates).

### Telerik UI for ASP.NET MVC is not listed in your current license file (TKL101)

Your license key does not include Telerik UI for ASP.NET MVC.

[Review the purchase options for Telerik UI for ASP.NET MVC](https://www.telerik.com/purchase/aspnet-mvc). If you have already purchased the required license, then [update your license key](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#license-key-updates).

### Your current license has expired (TKL102)

This error applies to perpetual licenses. It means that you are using a product version released outside the validity period of your license. To remove the error message, do either of the following:

* [Renew your license](https://www.telerik.com/account/your-licenses) and then [update your license key](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#license-key-updates).
* Use a Telerik UI for ASP.NET MVC version that was released within the subscription period of your perpetual license.

### Your subscription has expired (TKL103, TKL104)

This error applies to subscription licenses. [Renew your subscription](https://www.telerik.com/account/your-licenses) and then [update your license key](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license#license-key-updates).

### Your trial expired (TKL105)

[Purchase a commercial license to continue using Telerik UI for ASP.NET MVC](https://www.telerik.com/purchase/aspnet-mvc).

### License key is installed but the banner and watermark do not disappear

This is a known issue in version Telerik UI for ASP.NET MVC 2025.1.211 in scenarios related to deferring the initialization of the components, and in editing scenarios.

The following workaround can be applied to remove the banner and watermark.

1. Go to the [License Keys page](https://www.telerik.com/account/your-licenses/license-keys) in your Telerik account.

2. On the `Progress® Kendo UI® for jQuery` row, click the **View key** link in the **SCRIPT KEY** column.

   ![Get License Key](https://www.telerik.com/aspnet-mvc/documentation/assets/cd2d48df687700586c921240addf2db2/get-license-key.png)

3. Copy the JavaScript code snippet into a new file, for example, `telerik-license.js`.

4. Save the file using ASCII or UTF-8 encoding.

5. Add the script file to your project, for example, in the `Scripts` folder.

6. Add the file as a script reference right after the `kendo.aspnetmvc.min.js` reference or the Kendo UI scripts you are using.

```html
<script src="https://cdn.jsdelivr.net/npm/@progress/kendo-ui@2024.4.1112/umd/kendo.all.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@progress/kendo-ui@2024.4.1112/umd/kendo.aspnetmvc.min.js"></script>
<script src="~/Scripts/telerik-license.js"></script>


```

This issue can also be caused by referencing different versions of the `Kendo.Mvc.dll` and the required Kendo UI JavaScript files. Ensure that the `Kendo.Mvc.dll` and the required client-side resources referenced in the project have an identical version, for example, 2025.1.211.

### Could not load file or assembly 'Telerik.Licensing.Runtime'

If you experience the error *"The located assembly's manifest definition does not match the assembly reference."* use the following assembly redirect:

```
    <dependentAssembly>
        <assemblyIdentity name="Telerik.Licensing.Runtime" publicKeyToken="98bb5b04e55c09ef" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-<latest version of Telerik.Licensing package>" newVersion="<latest version of Telerik.Licensing package>" />
    </dependentAssembly>
```

### Your Deployed Application Shows a Banner and a Watermark

Ensure that you have set up an environment variable by following the steps from the [Use License Keys in CI/CD](https://www.telerik.com/aspnet-mvc/documentation/deployment/ci-cd-license-key) article.

Alternatively, if you have included the telerik-license.txt file into the project and the project is under source control, add the license file under source control as well.

## See Also

* [Download and Install License Key](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/setting-up-your-license)
* [Licensing FAQ](https://www.telerik.com/aspnet-mvc/documentation/installation/activating-your-license/licensing-faq)
* [Use License Keys in CI/CD](https://www.telerik.com/aspnet-mvc/documentation/deployment/ci-cd-license-key)
