# Telerik License Key

Telerik UI for Blazor requires activation through a license key during application build, test and publish. A license key is required for both trial and commercial licenses. This article describes how to download your personal license key and use it to activate the Telerik Blazor components.

> tip This documentation section applies to Telerik UI for Blazor version **8.0.0** and above. Older versions do not require a license key.

## Basics

To install a license key, you must have a commercial or trial license for:

* Telerik UI for Blazor
* Any product bundle that includes Telerik UI for Blazor, such as DevCraft.

If you are new to Telerik UI for Blazor, [sign up for a free trial](https://www.telerik.com/blazor-ui).

The `Telerik.UI.for.Blazor` NuGet package [depends on the `Telerik.Licensing` NuGet package](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#nuget-packages). During project build, test and publish, the `Telerik.Licensing` package automatically verifies the license key and activates Telerik UI for Blazor in that project.

Follow the steps below for [automatic](https://www.telerik.com/blazor-ui/documentation/installation/license-key#automatic-installation) or [manual](https://www.telerik.com/blazor-ui/documentation/installation/license-key#manual-installation) license key installation in your local development environment. Then, find out [how to use a Telerik deployment key during application deployment](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key).

An [invalid or missing license key results in app build warnings](https://www.telerik.com/blazor-ui/documentation/troubleshooting/license-key-errors) and watermarks in the application UI.

> warning The license key file is personal and confidential. Do not commit this file to source control and do not save it to a publicly accessible location!

## Automatic Installation

To download and install your Telerik license key automatically, use either of the following Telerik productivity tools:

* [Telerik Control Panel](https://docs.telerik.com/controlpanel/introduction)—this tool downloads and installs different Telerik products on your machine.
* [Telerik UI for Blazor Visual Studio extension](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/introduction)—this tool adds or upgrades Telerik UI for Blazor in new or existing apps.
* [Telerik CLI](https://www.telerik.com/blazor-ui/documentation/installation/telerik-cli)—this tool also allows you to quickly set up the [Telerik NuGet feed](https://www.telerik.com/blazor-ui/documentation/installation/nuget) and install the [Telerik Blazor MCP server](https://www.telerik.com/blazor-ui/documentation/ai/overview).

The above tools download and install a license key for you and make it available for all projects that you develop on your local machine. The license key file and location is specified in the [Manual Installation](https://www.telerik.com/blazor-ui/documentation/installation/license-key#manual-installation) section below.

> tip Update your license key [whenever you renew or purchase a new Telerik license](https://www.telerik.com/blazor-ui/documentation/installation/license-key#license-key-updates).

## Manual Installation

To download and install your Telerik license key:

1. Go to the <a href="https://www.telerik.com/account/your-licenses/license-keys" target="_blank">License Keys page</a> in your Telerik account.
2. Click the **Download License Key** button.
3. Save the `telerik-license.txt` file to:
   * (on Windows) `%AppData%\Telerik\telerik-license.txt`, for example, `C:\Users\...\AppData\Roaming\Telerik\telerik-license.txt`
   * (on Mac or Linux) `~/.telerik/telerik-license.txt`, for example, `/Users/.../.telerik/telerik-license.txt`

This will make the license key available to all Telerik .NET apps that you develop on your local machine.
If you need to activate Telerik UI for Blazor only in a specific app, then save `telerik-license.txt` to the root folder of your project or solution.

> tip Update your license key [whenever you renew or purchase a new Telerik license](https://www.telerik.com/blazor-ui/documentation/installation/license-key#license-key-updates).

## License Key Updates

Always install a new license key whenever you:

* renew or purchase a new Telerik license
* Start a new trial

The new license key includes information about all previous purchases. This process is referred to as a *license key update*.

* If you used [automatic license key installation](https://www.telerik.com/blazor-ui/documentation/installation/license-key#automatic-installation), then open the tool that you used to download and install the license key file. You can also update the license key file by using the [manual steps above](https://www.telerik.com/blazor-ui/documentation/installation/license-key#manual-installation).
* If you used the [manual license key installation](https://www.telerik.com/blazor-ui/documentation/installation/license-key#manual-installation), then repeat the same steps.
* To [update your deployment key in CI/CD environments](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key), get your new license key and update the environment variable value.

## Using Telerik Packages in Referenced Projects

Telerik UI for Blazor may be used in a referenced project in a multi-project app, for example:

* In the **Client** project of a Blazor Web App with **WebAssembly** or **Auto** render mode.
* In a Razor class library (RCL) project, which is used by another web or RCL project.

In such cases, you may see a yellow banner in the browser, which says "We couldn't verify your license key for Telerik UI for Blazor. Please see the build log for details and resolution steps".

There are two alternative ways to avoid the warning banner:

* Set `PrivateAssets="none"` to the Telerik UI for Blazor NuGet package registration tag. This approach is applicable only if the main (startup) app project directly references the project that includes Telerik UI for Blazor.
  ```XML.skip-repl
  <PackageReference Include="Telerik.UI.for.Blazor" Version="16.0.0" PrivateAssets="none" />
  ```

* Reference the `Telerik.Licensing` NuGet package explicitly in the main (startup) app project. This approach is required if you are using Telerik UI for Blazor in a project hierarchy with more than two levels. For example, the main (startup) app project A references a Razor Class Library (RCL) project B, which references RCL project C that includes Telerik UI for Blazor. You can use the same `Telerik.Licensing` version that is referenced by `Telerik.UI.for.Blazor`, or a newer version.
  ```XML.skip-repl
  <ItemGroup>
    <PackageReference Include="Telerik.Licensing" Version="*" />
  </ItemGroup>
  ```

## Troubleshooting

Refer to the [Troubleshooting License Key Errors](https://www.telerik.com/blazor-ui/documentation/troubleshooting/license-key-errors) page to find out what license key warnings you may see during application build and what they mean.

## Frequently Asked Questions

### Where do I need to install a license key?

A Telerik license key is required on all environments that build, test or publish Telerik Blazor apps. This includes:

* Local development environments. See [Automatic Installation](https://www.telerik.com/blazor-ui/documentation/installation/license-key#automatic-installation) and [Manual Installation](https://www.telerik.com/blazor-ui/documentation/installation/license-key#manual-installation) above.
* Environments that perform [deployment, continuous integration or continuous delivery](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key) (CI/CD) to run your apps on a test, staging or production environment. Such environments include Azure Pipelines, GitHub Actions, GitLab, Docker, Jenkins, and others.

> tip A license key is not required on the web server that hosts the already deployed web application.

### What is the difference between deployment keys and developer license keys?

Deployment keys are application-specific keys designed for build pipelines. They are shorter than developer license keys, which helps avoid environment-variable limits, and you can remove a deployment key, if it has been exposed. For new CI/CD pipelines, we recommend using deployment keys.

Developer license keys remain valid for CI/CD deployments and can be used in multiple pipelines, builds, and environments. However, their larger size can exceed the environment-variable limits of some CI/CD services. If a developer license key is exposed, you cannot revoke it independently.

### Does the license key expire?

Yes, the license key expires at the end of your license period. For trial users, this is at the end of your 30-day trial.

You need to download and install a new license key after:

* Starting a new trial
* Buying a new license
* Renewing an existing license
* Upgrading an existing license

An expired [perpetual license](https://www.telerik.com/purchase/faq/licensing-purchasing#licensing) key is valid for all Telerik UI for Blazor versions published before the license expiration date.

### Will Telerik UI for Blazor work with an expired license key?

This depends on the [Telerik UI for Blazor license type (perpetual, subscription, or trial)](https://www.telerik.com/purchase/faq/licensing-purchasing#licensing):

* *Perpetual licenses* function normally with an expired license key, as long as the application is using a [Telerik UI for Blazor version that was released before the license expiration date](https://www.telerik.com/support/whats-new/blazor-ui/release-history).
* *Subscription licenses* function normally in already deployed applications, as long as you do not rebuild and republish the app.
* *Trial licenses* function normally during the 30-day trial period.

Scenarios that do not match the above descriptions result in the following application behaviors:

* A popup banner appears on application startup.
* A watermark appears on the Telerik components.
* [A warning message appears in the application's build log](https://www.telerik.com/blazor-ui/documentation/troubleshooting/license-key-errors).

To avoid accidental license watermarks and notifications on your live site, you can [fail the application build and abort deployment](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key#abort-deployment-on-license-key-error) when there is an issue with the license key.

### I updated Telerik UI for Blazor in my app and got license errors. Why?

The most likely cause is that the new Telerik UI for Blazor version was released after the expiration date of your current license or license key. To fix this issue:

1. Renew your Telerik UI for Blazor license if necessary.
2. [Update your license key](https://www.telerik.com/blazor-ui/documentation/installation/license-key)

### Can I use the same license key in multiple builds?

You can use one license key in multiple pipelines, builds, and environments. However, each individual developer must use their own unique personal license key in their development environment.

### Do I need Internet to activate the license?

No, the license validation and activation occur offline.

### Should I add the license key to source control?

No, do not add the `telerik-license.txt` license key file or its contents to source control.

Do not store the license key in plain text in GitHub Actions Workflow definitions. Build servers [must use the `TELERIK_LICENSE` or `TELERIK_LICENSE_PATH` environment variable](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key).

### What happens if I use both the environment variable and the license key file?

If both the `TELERIK_LICENSE` environment variable and the `telerik-license.txt` file are present, then the environment variable will be used.
To use the license key file, unset the environment variable.

### What happens if several license key files exist?

If both a global and a project-specific `telerik-license.txt` files exist, then the project-specific license key will be used.

### My team has multiple licenses. Which key should we use?

To activate Telerik UI for Blazor:

* [Every developer must be assigned their own license or seat](https://www.telerik.com/purchase/faq/licensing-purchasing).
* Every developer must use a license key that is associated with their personal Telerik account.
* You can use [deployment keys in cloud build CI/CD environments](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key).

### How can IT set up Telerik UI for Blazor for multiple developers?

Installing the Telerik software on a machine and installing a developer license key are separate tasks. A machine-wide installer run by an IT tool does not place a developer license key in every user's profile.

For local development, set up the license key in each developer's user context:

1. Assign the developer a Telerik license or seat.
2. Sign in with the developer's Telerik account and run `telerik license get-key`, or follow the [manual license key installation](https://www.telerik.com/blazor-ui/documentation/installation/license-key#manual-installation) steps.
3. Save the resulting `telerik-license.txt` file in that user's operating system profile.

If an IT tool runs under a system account, perform the developer-specific license setup separately for each user. For CI/CD builds, use a deployment key with [`TELERIK_LICENSE` or `TELERIK_LICENSE_PATH`](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key) instead of installing a developer key in a user profile.

The [automated installer](https://www.telerik.com/blazor-ui/documentation/installation/automated) may use a protected default installation path on Windows. If the user does not have administrator access, choose an installation path where the user has full access.

### Are earlier Telerik UI for Blazor versions affected?

No, versions up to **7.1.0** released prior to February 2025 do not require a license key.

## Next Steps

* [Use Deployment Key in CI/CD Environment](https://www.telerik.com/blazor-ui/documentation/deployment/ci-cd-license-key)
* [Set Up the Telerik NuGet Feed](https://www.telerik.com/blazor-ui/documentation/installation/nuget)

## See Also

* [Troubleshoot License Key Errors](https://www.telerik.com/blazor-ui/documentation/troubleshooting/license-key-errors)
* [Get Started with Telerik UI for Blazor](https://www.telerik.com/blazor-ui/documentation/getting-started/web-app)
* [Workflow Details for Telerik UI for Blazor](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details)
