
What Is Schema Markup?
Schema markup is code added to a web page that describes its content in a standard vocabulary search engines can read directly. It tells them, for example, that a page is about a product with a price and rating, or an article with an author. Valid markup can make a page eligible for rich results. It does not guarantee them.
| Schema type | Use on | Can enable in Google |
|---|---|---|
| Organization | Home or about page | Knowledge panel details, logo |
| LocalBusiness | Location and contact pages | Business details in results |
| Product | Product pages | Price, availability, rating |
| Article | News and blog posts | Article features; clearer authorship |
| BreadcrumbList | All pages with breadcrumbs | Breadcrumb trail in results |
| Review and AggregateRating | Pages with genuine reviews | Star ratings, for eligible types |
| Event | Event pages | Date, place, tickets |
| Recipe | Recipe pages | Image, time, rating |
| VideoObject | Pages with video | Video features, key moments |
| JobPosting | Job advertisements | Job listings |
Rich result types change over time. Check Google’s current documentation before building around any one of them. The vocabulary itself is maintained at Schema.org.
What Is Structured Data, and What Is JSON-LD?
Structured data is the general term for information presented in a defined, machine-readable format. Schema markup is structured data using the Schema.org vocabulary.
Google describes structured data as a standardized format for providing information about a page and classifying the page content.
There are three formats:
| Format | How it works | Google’s view |
|---|---|---|
| JSON-LD | A script block, separate from the visible HTML | Recommended |
| Microdata | Attributes added to HTML elements | Supported |
| RDFa | Attributes added to HTML elements | Supported |
JSON-LD is a block of JavaScript notation placed in a script element with the type application/ld+json. It lists properties and values, such as the name, price and currency of a product. Because it sits apart from the page’s layout, it is easier to add and maintain.
Does Schema Markup Improve Rankings?
Not directly. Google describes structured data as a way to help it understand content and to enable special result features. It does not present it as a ranking boost.
Indirect effects are real:
- Richer listings can attract more clicks at the same position.
- Clearer understanding of what a page and an organisation are.
- Eligibility for features that plain pages cannot appear in.
Google’s structured data guidelines add that it does not guarantee your structured data will show up in search results, even when the markup is valid.
Which Schema Types Should a Business Site Use?
Start with a small, accurate set.
| Site type | Start with |
|---|---|
| Any business | Organization, BreadcrumbList, WebSite |
| Local business | LocalBusiness, with address, hours, phone |
| Online store | Product with offers; Organization with return policy |
| Publisher or blog | Article, with author and dates |
| Service business | Organization or LocalBusiness; Service where it fits |
| Events | Event |
| Software | SoftwareApplication |
Add more only where the page genuinely contains that content. Google’s local business documentation and product documentation list the properties each type needs.
What Happened to FAQ and How-To Rich Results?
Rich result types are added and retired. Google’s FAQ structured data page states that the FAQ rich result is no longer shown in Google Search. How-to rich results were withdrawn earlier.
What this means in practice:
- FAQPage markup is still valid Schema.org, and is harmless.
- It no longer produces an expanded FAQ listing on Google.
- Other search engines and AI systems may still read it.
- Visible questions and answers on the page remain valuable for readers and for answer extraction.
Do not add markup solely to chase a visual feature. Features change; accurate description of your content stays useful.
Want this handled for you?
Our SEO services start with a full audit and a written plan, followed by a monthly report that shows what changed and why.
See our SEO servicesHow Do You Add JSON-LD?
There are four common routes.
- A CMS plugin or built-in feature. WordPress SEO plugins, Shopify themes and similar tools output common types automatically.
- A template. A developer adds a script block that fills in values from your database: name, price, author.
- A tag manager. Possible, but markup injected by JavaScript is less dependable than markup in the HTML.
- By hand. For a few static pages, write the block and paste it into the head or body.
A product block, described in words: a script of type application/ld+json containing “@context” set to schema.org, “@type” set to Product, a name, an image, a description, a brand, and an “offers” object with price, priceCurrency and availability.
Rules:
- Generate markup from the same data that fills the visible page, so they cannot disagree.
- Include all required properties for the type; Google says items missing them are not eligible for rich results.
- Add recommended properties where you have the data.
- Use one consistent identifier for your organisation across pages.
What Are Google’s Rules for Structured Data?
Google’s general guidelines set the limits.
- Mark up only visible content. “Don’t mark up content that is not visible to readers of the page.”
- Be accurate. Markup must be a true representation of the page content.
- Be relevant. Do not mark a page as something it is not.
- Be complete. Provide required properties.
- Be specific. Use the most appropriate type.
- Do not mislead: no fake reviews, invented ratings or prices that differ from the page.
Breaking these can lead to a structured data manual action. Google says such an action removes a page’s eligibility for rich results; it does not affect ranking in web search.
Self-serving reviews are a common error. Marking up reviews of your own business on your own site, to get stars for the organisation, is not eligible.
How Do You Test Schema Markup?
| Tool | What it checks |
|---|---|
| Rich Results Test | Whether a page is eligible for Google rich results; shows errors and warnings |
| Schema Markup Validator | Whether markup is valid Schema.org, regardless of Google features |
| Search Console enhancement reports | Site-wide errors and valid items for detected types |
| URL Inspection | Markup Google found on a specific indexed page |
Process:
- Test the page or code before publishing.
- Fix errors, which block eligibility.
- Review warnings, which flag missing recommended properties.
- Publish, then request indexing.
- Watch the enhancement reports over the following weeks.
- Retest after any template change.
Which Mistakes Are Most Common?
- Markup that does not match visible content, such as an old price.
- Missing required properties.
- Two plugins outputting duplicate or conflicting markup.
- Review markup for self-written testimonials.
- Marking every page as an Article or a Product.
- Markup added by JavaScript that fails to render.
- Organization details that differ between pages.
- Leaving markup in place after the content was removed.
- Expecting stars or other features to appear at once, or at all.
Does Schema Help with AI Search?
It helps machines interpret a page, which is useful to any system reading it. Google states that no special structured data is required to appear in its AI features, and advises making sure structured data matches the visible text.
Treat schema as part of being clear and consistent, not as a route into AI answers. See our guides to semantic SEO and generative engine optimization.
How Do You Maintain It?
- Monitor Search Console enhancement reports monthly.
- Retest after redesigns and plugin updates.
- Keep data current: prices, availability, hours, dates.
- Review Google’s documentation yearly for changed requirements.
- Remove markup for retired content.
For where markup sits among page elements, see our on-page SEO guide. For product specifics, see SEO for ecommerce product pages.
Frequently Asked Questions
Does schema markup improve rankings?
Not directly. Google uses structured data to understand content and to enable rich results, and does not describe it as a ranking boost. A richer listing can earn more clicks, and clearer information helps search engines interpret your pages. Valid markup never guarantees a rich result.
What is JSON-LD?
JSON-LD is a format for structured data, written as a script block separate from the visible page content. Google recommends it because it is easier to add and maintain than formats woven into the HTML. It lists properties and values describing the page, such as a product’s name and price.
Which schema types should a business site use?
Begin with Organization and BreadcrumbList on any site. Add LocalBusiness for a physical location, Product for items you sell and Article for editorial content. Use only types that match what is actually on each page, and include the required properties for each.
Is FAQ schema still worth adding?
It no longer produces FAQ rich results on Google, which has retired that feature. The markup remains valid and harmless, and other systems may read it. The visible questions and answers on your page matter more than the markup. Do not add it expecting a visual enhancement.
Can wrong schema markup hurt my site?
Misleading or inaccurate markup can lead to a structured data manual action, which removes eligibility for rich results. Google says this does not affect ordinary ranking. Simple errors usually just mean the markup is ignored. Keep markup accurate and consistent with visible content.
Related Guides
Want this done for you?
See what each monthly plan includes, or send us your site and questions on WhatsApp. We do not promise rankings; we show the work and the data every month.
View SEO packages Chat on WhatsAppSources
- Schema.org
- Google Search Central: Introduction to structured data
- Google Search Central: General structured data guidelines
- Google Search Central: Local business structured data
- Google Search Central: Product structured data
- Google Search Central: FAQ structured data
- Google: Rich Results Test
- Google Search Central: AI features and your website



