Skip to content

Merge dimodi-patch-1-lazy-3854 into production #3855

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
dimodi merged 1 commit into from
Aug 12, 2026
Merged

Merge dimodi-patch-1-lazy-3854 into production #3855

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
5 changes: 2 additions & 3 deletions knowledge-base/common-lazy-load-assemblies-wasm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ page_title: Telerik Blazor Components and WebAssembly Lazy Load of Assemblies
slug: common-kb-lazy-load-assemblies-wasm
position:
tags:
ticketid: 1628239, 1633572
ticketid: 1628239, 1633572, 1717746
res_type: kb
components: ["general"]
---
Expand Down Expand Up @@ -52,11 +52,10 @@ All general guidance from the [Microsoft documentation](https://learn.microsoft.
<BlazorWebAssemblyLazyLoad Include="Telerik.Zip.wasm" />
<!-- PDF export (only for version 8.0.0 and above) -->
<BlazorWebAssemblyLazyLoad Include="Telerik.Documents.Spreadsheet.FormatProviders.Pdf.wasm" />
<!-- Licensing (only for version 8.0.0 and above ) -->
<BlazorWebAssemblyLazyLoad Include="Telerik.Licensing.Runtime.wasm" />
</ItemGroup>
````

* If using Telerik UI for Blazor version 8 or above, reference the `Telerik.Licensing` NuGet package explicitly in the client project that uses Telerik UI for Blazor, and the main startup project. This assembly cannot be lazy loaded due to runtime license verification.
* The assembly requirements depend on component usage, and not on feature usage. For example, both icon assemblies are always required, as our components render icons internally and must be aware of both types of icons. The assemblies, which are related to Excel and PDF export, are always required when using a Grid. `Telerik.Recurrence.wasm` is required only when using the Scheduler.
* Move the [`<TelerikRootComponent>`](slug:rootcomponent-overview) to a layout that is used only on pages that have the Telerik assemblies loaded.
* Lazy loading of assemblies does not support dynamic service injection. As a result, remove the Telerik service registration (`builder.Services.AddTelerikBlazor();`) from `Program.cs`. If you are using [localization for the Telerik Blazor components](slug:globalization-localization), define the the localization service for the Telerik components with the `Localizer` parameter of the `<TelerikRootComponent>`. The key thing is to instantiate the localization service inline. It cannot be injected as a variable from the `@code { }` block, because that will throw runtime errors.
Expand Down
Loading