From fa599ef32bf59f1747340ee04a83f8bef257ff4d Mon Sep 17 00:00:00 2001
From: Dimo Dimov <961014+dimodi@users.noreply.github.com>
Date: Wed, 21 May 2025 17:39:14 +0300
Subject: [PATCH] docs(Common): Add troubleshooting info for license
verification banner
---
installation/license-key.md | 22 ++++++++++++++++++++++
troubleshooting/license-key-errors.md | 7 +++++++
2 files changed, 29 insertions(+)
diff --git a/installation/license-key.md b/installation/license-key.md
index 38276f946..9dd11fe1d 100644
--- a/installation/license-key.md
+++ b/installation/license-key.md
@@ -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".
+
+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
+
+ ````
+
+* 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
+
+
+
+ ````
+
+## 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?
diff --git a/troubleshooting/license-key-errors.md b/troubleshooting/license-key-errors.md
index e918d4aab..8f075b877 100644
--- a/troubleshooting/license-key-errors.md
+++ b/troubleshooting/license-key-errors.md
@@ -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.
@@ -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)