Schema markup (also called structured data) is code you add to your HTML that helps search engines understand the meaning and context of your content — not just the text, but what it represents: a product, an article, a business, a recipe, an event.
In return, Google can display rich results in search — star ratings, prices, FAQs, event dates, breadcrumbs — that make your listing stand out and dramatically increase click-through rates.
What is JSON-LD? (The Recommended Format)
Schema markup can be written in three formats: JSON-LD, Microdata, and RDFa. Google recommends JSON-LD — it's the easiest to implement and maintain because it sits in a separate <script> block rather than being mixed into your HTML.
A basic Organization schema in JSON-LD:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Your Company Name",
"url": "https://yourdomain.com",
"logo": "https://yourdomain.com/logo.png",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+40-XXX-XXX-XXX",
"contactType": "customer service"
}
}
</script>What Rich Results Can Schema Unlock?
| Schema Type | Rich Result | Best For |
|---|---|---|
| FAQPage | FAQ dropdowns directly in search results | All websites |
| Product | Star ratings, price, availability | E-commerce |
| Article | News/article rich result with image | Blogs, news |
| LocalBusiness | Business info, hours, rating in Knowledge Panel | Local businesses |
| BreadcrumbList | Breadcrumbs shown under page title in SERP | All multi-level sites |
| HowTo | Step-by-step guide in search results | Tutorial content |
| Recipe | Cooking time, rating, ingredients in results | Food/cooking sites |
| Event | Event date, location, tickets | Event listings |
| VideoObject | Video thumbnail and duration in results | Video content |
| SoftwareApplication | App rating and price | SaaS, apps |
The 3 Schema Types Every Website Needs
1. Organization (or WebSite)
Tells Google basic information about your business: name, URL, logo, social profiles, contact information. This populates your Knowledge Panel.
2. WebPage or Article
Applied to individual pages. For blog posts, use Article with datePublished, dateModified, author, and publisher — these are key E-E-A-T signals.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"datePublished": "2025-05-15",
"dateModified": "2025-06-01",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Your Site Name",
"logo": {
"@type": "ImageObject",
"url": "https://yourdomain.com/logo.png"
}
}
}
</script>3. FAQPage
Adds expandable FAQ directly in your search result listing — significantly increasing the real estate your result occupies in the SERP. Implement on any page with a FAQ section.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is schema markup?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Schema markup is structured data code that helps search engines understand page content and display rich results."
}
}
]
}
</script>How to Generate Schema Markup for Free
Use the Optyxo Schema Generator — select your schema type, fill in the fields, and get the correct JSON-LD code to copy and paste into your site.
After adding schema, validate it with the Optyxo Structured Data Validator — it checks your markup against schema.org specs and Google's requirements, flagging any errors before they affect your search appearance.
Common Schema Markup Mistakes
1. Marking up content that isn't visible on the page
Google requires that schema markup reflects what users can actually see. If you add a star rating in schema but there's no rating visible on the page, Google may ignore or penalize the markup.
2. Using incorrect property values
Schema has strict data types. A datePublished must be in ISO 8601 format (2025-05-15), not "May 15, 2025". Use the Optyxo validator to catch type errors.
3. Not updating schema when page content changes
If your article schema says dateModified: 2023-01-01 but the page was heavily updated in 2025, the schema is misleading. Keep schema in sync with actual page content.
4. Adding FAQPage schema to spammy content
Google has restricted FAQPage rich results to reputable, high-quality sites. Low-quality content with FAQPage schema may not get the rich result — focus on content quality first.
Schema Markup and AI Search
Schema markup is increasingly important for AI search engines (ChatGPT Search, Perplexity, Google AI Overviews). These systems use structured data to understand entity relationships — your schema helps them correctly identify your business, your content, and your expertise signals.
The Optyxo AI Visibility audit checks whether your schema markup is adequate for AI consumption and flags missing schemas that could improve your presence in AI-generated answers.
Frequently Asked Questions
Does schema markup directly improve Google rankings?
Not directly — Google's John Mueller has confirmed structured data isn't a direct ranking factor. However, rich results from schema markup increase your click-through rate from search, which improves organic traffic. Higher CTR with consistent rankings sends positive behavioral signals to Google over time.
How do I know if my schema is working?
Use the Optyxo Structured Data Validator to check for errors. Then use Google Search Console → Rich Results → check your URL in the Rich Results Test to see if Google can process your schema and if you're eligible for rich results.
Can I have multiple schema types on one page?
Yes. In fact, most pages benefit from multiple schemas: a blog post might have Article + FAQPage + BreadcrumbList all on the same page. Put each in its own <script type="application/ld+json"> block, or combine them in one block as an array.
What's the difference between schema.org and JSON-LD?
Schema.org is the vocabulary — the defined types (Article, Product, Organization) and their properties. JSON-LD is the format used to encode that vocabulary in HTML. Think of schema.org as the language and JSON-LD as the way you write it.