Microdata on html element

[kaaax0815]

I currently change the head with something like this

head: () => ({
    meta: [
      {
        title: 'FAQ - App',
      },
    ],

Setting lang here works currently and sets it on the html element.
but when using itemscope and itemtype it creates a meta element, which doesn't make much sense.

Is there any way to set Microdata for the html element?

[mrx-arafat]

Yes—put itemscope and itemtype on the document’s <html> element, using React’s itemScope and itemType props; keep title: 'FAQ - App' in head().meta.

I traced why you get a <meta>: the head builder special-cases titles and JSON-LD, then makes other entries into meta tags. Those entries don’t configure <html>.

If you’re using Start, find the existing <html> opening tag in src/routes/__root.tsx and add the props there. In the current example, that’s RootDocument, used as shellComponent:

<html lang="en" itemScope itemType="https://schema.org/FAQPage">

Keep your existing language, children and closing tag. FAQPage is my test value; use the schema type you intended for itemtype. Remove the microdata entry from head().meta so it stops generating the extra <meta>. If your host supplies the HTML document, edit its <html> tag instead.

I reproduced this with Router 1.170.45, Start 1.169.3, React 19.2.0, Node 24.21.0 on Linux. Server-rendering a root route through StartServer produced this after removing that entry:

<html lang="en" itemScope="" itemType="https://schema.org/FAQPage"><head></head><body><main>FAQ</main></body></html>

I tested SSR output, not hydration or search-engine eligibility. Check your rendered HTML: the microdata attributes should be on <html>, with no microdata <meta> left in <head>.