The Marsen glossary

Schema Markup

Structured data commonly expressed with the Schema.org vocabulary to describe page information.

By Aranyak Sengupta3 min read

The short answer

Schema markup is structured data written with the Schema.org vocabulary, usually as JSON-LD in a page's HTML. It tells search engines and AI systems what the page describes, such as an organization, a local business, a product, a service or an article, using standard types and properties.

How schema markup works

Schema.org defines types (Organization, LocalBusiness, Service, Product, Article, FAQPage, BreadcrumbList and hundreds more) and the properties each can have. A JSON-LD script block on the page uses these to describe the page's main entities. Google recommends JSON-LD because it sits apart from the visible HTML and is easy to maintain. Google uses some types to decide eligibility for rich results, and documents which properties are required for each feature.

A worked example

A dental clinic's contact page shows its name, address, phone number and opening hours. The page adds a Dentist block (a LocalBusiness subtype) with the same name, address, telephone, opening hours and website, plus a stable @id. The clinic checks the markup in Google's Rich Results Test, fixes a mismatched phone format, and confirms that the details match its Google Business Profile exactly. It does not add a star rating because no reviews are shown on the page.

  • Type: Dentist (a LocalBusiness subtype)
  • Properties: name, address, telephone, openingHours, url, @id
  • Consistency: identical to the visible page and the business profile
  • Excluded: ratings not shown on the page

Common mistakes

Marking up content that is not visible, adding reviews or ratings the page does not show, using a different company name or phone number from the rest of the web, or emitting duplicate and conflicting blocks from several plugins. Each of these can make markup ignored or cause a manual action. Use one consistent source for the markup and test after every template change.

Generate schema markup
JSON-LD implementation guide
Astro SEO checklist

Schema markup and AI search

Schema markup can make company facts and relationships explicit, which helps systems interpret a page consistently. It does not guarantee an AI citation, and Google says no special markup is required for its AI features. Clear visible content remains the primary signal.

Schema markup vs structured data

Structured data is the general idea of labelled, machine-readable information. Schema markup is one specific way of expressing it on web pages, using the Schema.org vocabulary. JSON-LD, Microdata and RDFa are formats for writing that markup; JSON-LD is the most common today.

Take the next step

Explore the related guide, or look up another term.

Continue reading
Browse the glossary

Built around your business

Put what you’ve learned to work.

Book a demo

Bring us your questions. We’ll help you find a useful next step for your business.