Can I add JSON-LD via Next.js Metadata API?

No — Metadata API handles tags, , , OG, Twitter. JSON-LD is a tag, not a meta tag. Render JSON-LD manually as in your page component or layout.

Should JSON-LD be in layout.tsx or page.tsx?

Both. layout.tsx: site-wide schema (Organization, WebSite, SiteNavigationElement) — renders on every page. page.tsx: page-specific schema (Article on blog post, Product on product page, FAQPage on FAQ). Layered approach is clean.

How do I add Article schema to Next.js blog posts?

app/blog/[slug]/page.tsx: fetch article data, build Article JSON-LD with headline, image, datePublished, dateModified, author (Person), publisher (Organization), mainEntityOfPage. Render via dangerouslySetInnerHTML. Type-safe with a buildArticleSchema helper.

Why does Search Console show 'missing field' on Next.js JSON-LD?

Required fields missing from your generated object. Common: Article missing author or publisher; Product missing offers; FAQPage missing mainEntity. Rich Results Test shows exactly which fields. Fix in schema builder helper.

Best Next.js libraries for JSON-LD?

next-seo (popular, includes JSON-LD components for common types). Or roll your own helpers (more control, no library dependency). For typed schema, schema-dts (TypeScript types for schema.org) prevents shape errors at compile time.

How to Fix JSON-LD in Next.js (App Router, RSC)

Next.js Metadata API handles most SEO meta but not JSON-LD — schema must be added manually via

About dev.aiwebpageseo

dev.aiwebpageseo.com is a data-driven SEO and AEO (Answer Engine Optimisation) platform providing a free suite of technical website tools. Rather than relying on AI-theorised assumptions, the platform analyses live URL performance, delivering objective diagnostics, page speed metrics, CLS debugging, and site crawl data alongside actionable technical tutorials.