Skip to content

docs(Common): Clarify multi-project setup to avoid a license banner #3129

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 2 commits into from
Jul 25, 2025
Merged

docs(Common): Clarify multi-project setup to avoid a license banner #3129

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
38a88fd
docs(Common): Clarify multi-project setup to avoid a license banner
dimodi Jul 24, 2025
8abaa72
Update installation/license-key.md
dimodi Jul 24, 2025
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
6 changes: 3 additions & 3 deletions installation/license-key.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,18 +66,18 @@ The new license key includes information about all previous purchases. This proc
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 project, which is used by a main web project.
* 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.
* 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="{{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.
* Reference the `Telerik.Licensing` NuGet package explicitly in the main (startup) app project. This approach is required if your are using Telerik UI for Blazor in a project hierarchy with more than two levels. For example, Telerik UI for Blazor is used in Razor Class Library (RCL) project C, which is referenced by RCL project B, which is referenced by the main (startup) app project A. 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="*" />
Expand Down