/ Learning Hub / Schema Builder Fixes

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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
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 PLANNED
Theme-generated Product schema editing, the apps that add review schema cleanly, custom-Liquid injection for richer markup.
โš›๏ธ Build schema in Next.js PLANNED
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 โ†’
Related Guides: Schema Builder Guide  ยท  Example Output  ยท  AI Schema Guide  ยท  Rich Snippets Guide
๐Ÿ’ฌ Got a problem?