{"slug":"schema-generator","title":"Schema Generator — JSON-LD Markup for Any Page Type","tags":["seo","schema","structured-data","json-ld","rich-results"],"agent_summary":"Generates JSON-LD schema markup for any page type using the correct schema.org type hierarchy. Covers Article, FAQ, HowTo, Product, LocalBusiness, Person, Organization, BreadcrumbList, Event, and Video.","trigger_phrases":["schema markup","JSON-LD","structured data","generate schema","schema for my page","rich results schema","schema.org markup","schema generator"],"runnable":true,"markdown":"\n## Schema Priority Order for Local Businesses\n\nThe Merlino 5 Easy Wins schema priority sequence:\n\n| Schema Type | Speed to Results | Page Type |\n|-------------|-----------------|-----------|\n| Q&A Schema (QAPage) | Hours | Any page with a question block |\n| FAQ Schema (FAQPage) | 1-3 days | Service pages, FAQ pages |\n| LocalBusiness + @id | Days to weeks | Homepage, contact page |\n| AggregateRating | 1-2 weeks | Homepage, service pages |\n| VideoObject | 1-2 weeks | Pages with embedded video |\n\nStart with Q&A Schema. It ranks fastest. Move down the priority list after each type is deployed and indexed.\n\n## Page-Type to Schema-Type Mapping\n\n| Page Type | Required Schema | Optional Schema |\n|-----------|----------------|-----------------|\n| Homepage | LocalBusiness + Organization + WebSite | AggregateRating, FAQPage |\n| Service page | Service + FAQPage | AggregateRating, HowTo |\n| Location page | LocalBusiness (branch) + FAQPage | GeoCoordinates, OpeningHoursSpecification |\n| Blog article | Article (or BlogPosting) + Person (author) | FAQPage, VideoObject |\n| FAQ page | FAQPage | HowTo |\n| Product page | Product + Offer + AggregateRating | Review |\n| About page | Organization + Person | ItemList |\n| Contact page | LocalBusiness | ContactPoint |\n\n## Critical Rules\n\n**@id is mandatory on LocalBusiness and Organization schemas.** Link to the GMB CID URL (not the website homepage). This anchors the entity to Google's Knowledge Graph.\n\n**AggregateRating must come from third-party sources only** — Google, Yelp, Facebook. Never self-host rating data or make up rating numbers. Policy violation = rich results penalty.\n\n**FAQPage requires visible Q&A on page.** Every question-answer pair in the schema must appear as readable text on the page. Hidden content violates rich results guidelines.\n\n**Stacking schema types uses `@graph` pattern.** When a page needs multiple schema types, wrap them in a single `@graph` array, not separate script tags.\n\n## LocalBusiness + AggregateRating Stack (Standard Template)\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@graph\": [\n {\n \"@type\": \"LocalBusiness\",\n \"@id\": \"https://g.co/kg/m/0EXAMPLE\",\n \"name\": \"Smith Roofing\",\n \"url\": \"https://smithroofing.com\",\n \"telephone\": \"+1-813-555-0123\",\n \"address\": {\n \"@type\": \"PostalAddress\",\n \"streetAddress\": \"123 Main St\",\n \"addressLocality\": \"Tampa\",\n \"addressRegion\": \"FL\",\n \"postalCode\": \"33602\"\n },\n \"aggregateRating\": {\n \"@type\": \"AggregateRating\",\n \"ratingValue\": \"4.9\",\n \"reviewCount\": \"127\",\n \"bestRating\": \"5\"\n },\n \"openingHoursSpecification\": [\n {\n \"@type\": \"OpeningHoursSpecification\",\n \"dayOfWeek\": [\"Monday\",\"Tuesday\",\"Wednesday\",\"Thursday\",\"Friday\"],\n \"opens\": \"08:00\",\n \"closes\": \"18:00\"\n }\n ]\n }\n ]\n}\n```\n\n## AI Discoverability Schema Checklist\n\nSchema also signals to AI platforms (ChatGPT Browse, Perplexity, Gemini):\n\n- [ ] `knowsAbout` array (3+ topics) on Organization or Person schema\n- [ ] `sameAs` links to 5+ platforms (Wikidata first, then Wikipedia, LinkedIn, YouTube)\n- [ ] `speakable` on Article schema (marks passages for voice/AI reading)\n- [ ] `@id` cross-references between schemas on the same page\n- [ ] JSON-LD in `` of server-rendered HTML (not JavaScript-injected)\n\n## Validation\n\nBefore deployment, validate every schema block:\n1. Google Rich Results Test: `https://search.google.com/test/rich-results`\n2. Schema.org Validator: `https://validator.schema.org`\n\nBoth must pass. One passing is not sufficient — the tools catch different error types.\n\n## Cross-References\n\n- `schema-stack` — full stacking methodology and Merlino 5 Easy Wins sequence\n- `schema-template-library` — complete template library for all schema types\n- `eeat-audit` — E-E-A-T signals reinforced through schema (author, credentials, organization)\n- `local-schema-builder` — LocalBusiness schema specialized for service-area businesses\n\n#seo-sop #seo #schema #structured-data #json-ld #rich-results\n","html":"

Schema Priority Order for Local Businesses

The Merlino 5 Easy Wins schema priority sequence:

| Schema Type | Speed to Results | Page Type |\n|-------------|-----------------|-----------|\n| Q&A Schema (QAPage) | Hours | Any page with a question block |\n| FAQ Schema (FAQPage) | 1-3 days | Service pages, FAQ pages |\n| LocalBusiness + @id | Days to weeks | Homepage, contact page |\n| AggregateRating | 1-2 weeks | Homepage, service pages |\n| VideoObject | 1-2 weeks | Pages with embedded video |

Start with Q&A Schema. It ranks fastest. Move down the priority list after each type is deployed and indexed.

Page-Type to Schema-Type Mapping

| Page Type | Required Schema | Optional Schema |\n|-----------|----------------|-----------------|\n| Homepage | LocalBusiness + Organization + WebSite | AggregateRating, FAQPage |\n| Service page | Service + FAQPage | AggregateRating, HowTo |\n| Location page | LocalBusiness (branch) + FAQPage | GeoCoordinates, OpeningHoursSpecification |\n| Blog article | Article (or BlogPosting) + Person (author) | FAQPage, VideoObject |\n| FAQ page | FAQPage | HowTo |\n| Product page | Product + Offer + AggregateRating | Review |\n| About page | Organization + Person | ItemList |\n| Contact page | LocalBusiness | ContactPoint |

Critical Rules

@id is mandatory on LocalBusiness and Organization schemas. Link to the GMB CID URL (not the website homepage). This anchors the entity to Google's Knowledge Graph.

AggregateRating must come from third-party sources only — Google, Yelp, Facebook. Never self-host rating data or make up rating numbers. Policy violation = rich results penalty.

FAQPage requires visible Q&A on page. Every question-answer pair in the schema must appear as readable text on the page. Hidden content violates rich results guidelines.

Stacking schema types uses @graph pattern. When a page needs multiple schema types, wrap them in a single @graph array, not separate script tags.

LocalBusiness + AggregateRating Stack (Standard Template)

{\n  \"@context\": \"https://schema.org\",\n  \"@graph\": [\n    {\n      \"@type\": \"LocalBusiness\",\n      \"@id\": \"https://g.co/kg/m/0EXAMPLE\",\n      \"name\": \"Smith Roofing\",\n      \"url\": \"https://smithroofing.com\",\n      \"telephone\": \"+1-813-555-0123\",\n      \"address\": {\n        \"@type\": \"PostalAddress\",\n        \"streetAddress\": \"123 Main St\",\n        \"addressLocality\": \"Tampa\",\n        \"addressRegion\": \"FL\",\n        \"postalCode\": \"33602\"\n      },\n      \"aggregateRating\": {\n        \"@type\": \"AggregateRating\",\n        \"ratingValue\": \"4.9\",\n        \"reviewCount\": \"127\",\n        \"bestRating\": \"5\"\n      },\n      \"openingHoursSpecification\": [\n        {\n          \"@type\": \"OpeningHoursSpecification\",\n          \"dayOfWeek\": [\"Monday\",\"Tuesday\",\"Wednesday\",\"Thursday\",\"Friday\"],\n          \"opens\": \"08:00\",\n          \"closes\": \"18:00\"\n        }\n      ]\n    }\n  ]\n}\n

AI Discoverability Schema Checklist

Schema also signals to AI platforms (ChatGPT Browse, Perplexity, Gemini):

[ ] knowsAbout array (3+ topics) on Organization or Person schema
[ ] sameAs links to 5+ platforms (Wikidata first, then Wikipedia, LinkedIn, YouTube)
[ ] speakable on Article schema (marks passages for voice/AI reading)
[ ] @id cross-references between schemas on the same page
[ ] JSON-LD in <head> of server-rendered HTML (not JavaScript-injected)

Validation

Before deployment, validate every schema block:

Google Rich Results Test: https://search.google.com/test/rich-results
Schema.org Validator: https://validator.schema.org

Both must pass. One passing is not sufficient — the tools catch different error types.

Cross-References

schema-stack — full stacking methodology and Merlino 5 Easy Wins sequence
schema-template-library — complete template library for all schema types
eeat-audit — E-E-A-T signals reinforced through schema (author, credentials, organization)
local-schema-builder — LocalBusiness schema specialized for service-area businesses

#seo-sop #seo #schema #structured-data #json-ld #rich-results

\n"}