How to Fix Every Schema Builder Finding

The Schema Markup Builder generates and validates JSON-LD for your pages. It catches the structural problems that prevent rich-result eligibility — wrong types, missing required fields, broken nesting, dangling entity references. This index covers fixes for every finding the builder raises.

New here?

Start with the Schema Builder Guide for the basics, or the example output.

By finding type

Findings fall into these categories. Pick yours:

🏷️ Fix wrong schema type for the content LIVE

A recipe page tagged as Article won't earn Recipe rich snippets. A how-to with steps should be HowTo, not Article. The decision tree: most specific type that fits, never broader. The schema.org hierarchy in plain English.

📋 Fix missing required fields per type LIVE

Each schema type has Google-required fields for rich-result eligibility. Product needs offers and aggregateRating. Recipe needs ingredients and instructions. The full required-fields cheatsheet per type.

🧬 Fix wrong nesting and graph structure LIVE

Author should be a Person entity, not a string. Publisher should be Organization. The @graph pattern that links entities clean across types. The flat-vs-nested decision per use case.

🆔 Fix @id references that don't resolve LIVE

Article references author by @id; author Person not defined. Organization referenced everywhere; defined nowhere. The closed-graph rule and the validator patterns to enforce it.

⚔️ Fix multiple competing schemas per page LIVE

Yoast outputs Article schema. You added Product schema. Site adds Organization schema. Three separate JSON-LD blocks confuse Google. Consolidate into a single @graph or pick one source.

🖼️ Fix image and logo schema issues LIVE

Logo too small (Google requires 112×112+), image not crawlable (relative URL or noindex), missing ImageObject wrapper for rich-result eligibility. Square, landscape, portrait crops.

📅 Fix date and time format issues LIVE

ISO 8601 (2026-05-18T14:30+01:00), no exceptions. The CMS templates that output wrong formats. Timezone-handling for sites that publish globally.

📞 Fix Organization and LocalBusiness fields LIVE

Organization sameAs for social profile linking. LocalBusiness with full address, phone, opening hours, geo coordinates. The Knowledge Graph signals that come from clean Organization schema.

By platform

How schema is generated depends on your CMS:

📰 Build schema in WordPress LIVE

Yoast / Rank Math vs dedicated schema plugins, the override patterns when default schema is wrong, custom-post-type schema for non-standard content.

🛒 Build schema in Shopify LIVE

Theme-generated Product schema editing, the apps that add review schema cleanly, custom-Liquid injection for richer markup.

⚛️ Build schema in Next.js LIVE

Metadata API patterns, next-seo library, dynamic JSON-LD from CMS content, the validation-in-CI workflow.

What our Schema Builder checks

The builder generates schema for the type you select, validates against schema.org and Google's Rich Results criteria, identifies missing fields, checks nesting, and outputs ready-to-paste JSON-LD. For the full reference, see the Schema Builder Guide.

🗂️ Build your schema first

Use the builder. Most sites have rich-result eligibility within reach — just need the schema right.

Open Schema Builder →

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.