Skip to content

docs(Common): Add troubleshooting info for license verification banner #2982

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 21, 2025
Merged

docs(Common): Add troubleshooting info for license verification banner #2982

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions installation/license-key.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,28 @@ The new license key includes information about all previous purchases. This proc
* If you used the [manual license key installation](#manual-installation), then repeat the same steps.
* To [update your license key in CI/CD environments](slug:deployment-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 WebAssembly app that uses server-side pre-rendering. In such cases, you can briefly 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".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The style guide recommends for error messages (this includes warnings as well) to be rendered in monospace. See here.


There are two alternative ways to avoid the warning banner:

* Set `PrivateAssets="none"` to the Telerik UI for Blazor NuGet package registration tag.
````XML.skip-repl
<PackageReference Include="Telerik.UI.for.Blazor" Version="{{site.uiForBlazorLatestVersion}}" PrivateAssets="none" />
````

* Reference the `Telerik.Licensing` package explicitly in all projects that reference other projects with Telerik packages. You can use the same version that is referenced by the `Telerik.UI.for.Blazor` NuGet package, or a newer version.
````XML.skip-repl
<ItemGroup>
<PackageReference Include="Telerik.Licensing" Version="*" />
</ItemGroup>
````

## Troubleshooting

Refer to the [Troubleshooting License Key Errors](slug: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

### Does the license key expire?
Expand Down
7 changes: 7 additions & 0 deletions troubleshooting/license-key-errors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ A Telerik license key error may occur in the following scenarios:
* The license key is outdated or does not include the product version that you are using.
* Your subscription license or trial has expired.
* You have different 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.
* Telerik UI for Blazor is used in the **Client** project of a WebAssembly app that uses pre-rendering. In such cases, you can briefly 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](#we-couldn-t-verify-your-license-key-for-telerik-ui-for-blazor-yellow-banner)".

Refer to the specific error messages and tips below.

Expand Down Expand Up @@ -70,6 +71,12 @@ This error applies to subscription licenses. [Renew your subscription](https://w

[Purchase a commercial license to continue using Telerik UI for Blazor](https://www.telerik.com/purchase/blazor-ui).

### We couldn't verify your license key for Telerik UI for Blazor (yellow banner)

This section assumes an existing valid license key, so that the problem is not any of the above.

If you briefly see a yellow warning banner in the web browser that says "**We couldn't verify your license key**", then refer to [Using Telerik Packages in Referenced Projects](slug:installation-license-key#using-telerik-packages-in-referenced-projects).

## See Also

* [Download and Install License Key](slug:installation-license-key)
Expand Down
Loading