Enable Interactive Render Mode

Jan 20, 2026
3 minutes to read

You can create applications that render content in static server-side render mode (static SSR). In this mode, components are rendered on the server and returned to the client without any interactivity.

Although most DevExpress Blazor components are interactive, you can use the following components in static render mode with limitations.

Accordion to display a single-level structure or an accordion with initially expanded groups.
Chart to display data as a static image.
Drawer in permanently visible mode or dynamic using query parameters or CSS rules.
Filter Builder to display predefined filter criteria.
Form Layout excluding collapsible and tabbed groups.
Grid to display static data on a single page.
Grid Layout.
List Box to display items.
Loading Panel to indicate progress with streaming rendering.
Menu to display one level of a hierarchy.
Pivot Grid to display static data on a single page.
Pivot Table to display static data on a single page.
Pie Chart to display data as a static image.
Polar Chart to display data as a static image.
Scheduler to display data in a pre-defined time interval.
Splitter excluding collapsible panes.
Stack Layout.
TreeList to display static data on a single page.
TreeView to display a single-level tree or a tree with initially expanded nodes.
Wait Indicator to indicate progress with streaming rendering.

Enable interactivity for an individual component, a page, or the entire application to allow DevExpress components to execute scripts and display data without limitations.

Prerequisites

To enable interactivity, ensure that required services and configuration are added in the Program.cs file:

Program.cs

razor

builder.Services.AddRazorComponents()
.AddInteractiveServerComponents()
.AddInteractiveWebAssemblyComponents();
...
app.MapRazorComponents<App>()
.AddInteractiveServerRenderMode()
.AddInteractiveWebAssemblyRenderMode();

Enable Interactivity for a Component

If you specify interactive render mode for a DevExpress component, it can cause the following error: Cannot pass the parameter 'X' to component 'Y' with rendermode 'InteractiveServerRenderMode'. The reason for this error is that an interactive component cannot contain non-serializable parameters, such as render fragments.

To solve the issue, wrap the DevExpress component in a parent component that only has serializable parameters. The following code sample adds an interactive DxAccordion component to a static page.

Wrap the DxAccordion component in another component (WrapperComponent) that does not have parameters.
Add WrapperComponent to a static page.

Refer to the following topic for additional information: Child component with a serializable parameter

Enable Interactivity on a Razor Page

Add the @rendermode directive on the page to enable interactivity.

razor

@rendermode InteractiveServer

Enable Interactivity for The Entire Application

Specify the @rendermode directive in HeadOutlet and Routes components to enable interactivity for the entire application.

App.razor

razor

<head>
    @* ... *@
    <HeadOutlet @rendermode="InteractiveServer" />
</head>
<body>
    <Routes @rendermode="InteractiveServer" />
    @* ... *@
</body>

Refer to the following topic for additional information: Apply a render mode to the entire app.