{"record":{"id":"98f58293f258a91f","repo":"dotnet/aspnetcore","slug":"root-components-cannot-be-marked-as-interactive-t","errorCode":null,"errorMessage":"Root components cannot be marked as interactive. The element must be rendered statically so that scripts are not evaluated multiple times.","messagePattern":"Root components cannot be marked as interactive\\. The element must be rendered statically so that scripts are not evaluated multiple times\\.","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/Components/Web.JS/src/Services/ComponentDescriptorDiscovery.ts","lineNumber":181,"sourceCode":" } else {\n return;\n }\n }\n}\n\nfunction parseCommentPayload(json: string): ServerComponentMarker | WebAssemblyComponentMarker | AutoComponentMarker {\n const payload = JSON.parse(json);\n const { type } = payload;\n if (type !== 'server' && type !== 'webassembly' && type !== 'auto') {\n throw new Error(`Invalid component type '${type}'.`);\n }\n\n return payload;\n}\n\nfunction assertNotDirectlyOnDocument(marker: Node) {\n if (marker.parentNode instanceof Document) {\n throw new Error('Root components cannot be marked as interactive. The element must be rendered statically so that scripts are not evaluated multiple times.');\n }\n}\n\nfunction getComponentEndComment(payload: ComponentMarker, start: Comment, iterator: ComponentCommentIterator): Comment | undefined {\n const { prerenderId } = payload;\n if (!prerenderId) {\n return undefined;\n }\n\n while (iterator.next() && iterator.currentElement) {\n const node = iterator.currentElement;\n if (node.nodeType !== Node.COMMENT_NODE) {\n continue;\n }\n if (!node.textContent) {\n continue;\n }\n","sourceCodeStart":163,"sourceCodeEnd":199,"githubUrl":"https://github.com/dotnet/aspnetcore/blob/294cab2f9b2e03af6b953820c7ab497c3c8b7ad9/src/Components/Web.JS/src/Services/ComponentDescriptorDiscovery.ts#L163-L199","documentation":"Thrown by assertNotDirectlyOnDocument (ComponentDescriptorDiscovery.ts:181) when a component marker's direct parent is the Document node itself — i.e. someone tried to make the root element an interactive (Server/WebAssembly/Auto) component. Blazor requires the root to remain static SSR so that \n \n","handlingStrategy":"validation","validationCode":"function assertRootIsStatic(rootComponentType: string, renderMode?: string) {\n if (renderMode && renderMode !== 'StaticServer' && rootComponentType === 'html') {\n throw new Error('Do not apply an interactive rendermode to the document root.');\n }\n}","typeGuard":"function isSafeRenderModeForRoot(mode: string | undefined): boolean {\n return !mode || mode === 'StaticServer';\n}","tryCatchPattern":null,"preventionTips":["Keep rendermode attributes off /document-level components.","Apply interactive rendermodes only to nested routable components.","Review App.razor / Routes.razor in code review."],"tags":["blazor","rendermode","root-component","ssr","document","scripts"],"analyzedSha":"294cab2f9b2e03af6b953820c7ab497c3c8b7ad9","analyzedAt":"2026-08-06T20:08:02.189Z","schemaVersion":2},"datasetVersion":"2026-08-06T23:17:07.152Z"}