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

dimodi · web-flow · commit 558ae8f18885 · 2025-05-21T19:16:10.000+03:00
diff --git 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
+  <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?
diff --git 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)
