The Marsen glossary
Schema Markup
Structured data commonly expressed with the Schema.org vocabulary to describe page information.
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.
Built around your business
Put what you’ve learned to work.
Book a demoBring us your questions. We’ll help you find a useful next step for your business.