SEO
Schema markup guide: what to mark up and how to test it
Schema markup is a way of telling search engines, in machine language, what your page content is: this is a product, this is an article, this is an event, this is a business. Google uses it to understand the page and, in some cases, to show rich appearances in results such as star ratings, prices or event dates.
Which format?
Google recommends JSON-LD: a <script type="application/ld+json"> block placed somewhere on the page. Microdata and RDFa, embedded within HTML tags, are also supported but harder to maintain. If your stack allows it, go with JSON-LD.
The golden rule: don't mark up what users can't see
The information you mark up should also be visible to users on the page. Putting a review rating that never appears on the page, or a price that doesn't exist, into schema violates Google's structured data guidelines and can cost you rich result eligibility. Think of schema as a mirror of the page content.
Types that help most sites
- Organization / LocalBusiness: Business name, logo, contact, address. On the home page.
- Article / BlogPosting: Headline, author, publish and update dates, image.
- BreadcrumbList: The page's place in the site hierarchy, shown as a path instead of a URL in results.
- Product + Offer: Price, availability and rating for e-commerce. See the e-commerce SEO checklist.
- Event, Recipe, VideoObject and others, when you have that content.
The current situation with FAQ and HowTo
Many older guides still say "always add FAQ schema." The reality has changed: Google retired FAQ rich results in May 2026 and withdrew the related documentation. An FAQ section can still stay on the page if it helps users, but don't expect a rich result from it. Always check Google's current search gallery documentation for what's still supported; the list changes over time.
How to test
- Before publishing, try the code or live URL in the Rich Results Test; it shows which rich results the page is eligible for.
- After publishing, monitor errors in Search Console's enhancement / rich result reports and the URL Inspection tool.
- Re-test whenever you change a template (theme update, plugin); schema can break silently.
Common mistakes
- Copying the same Product schema across all pages,
- A theme and a plugin both generating the same schema (a double Organization, say),
- Fake or inflated rating data,
- Expecting "add schema, get rankings." Structured data is not a ranking guarantee; it contributes to understanding and appearance.
For a quick look at what schema your site already has, our SEO analysis tool is a starting point. The full technical sweep is in the technical SEO audit guide.
