Back to Blog

SEO

Schema markup guide: what to mark up and how to test it

Admin User
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

  1. Before publishing, try the code or live URL in the Rich Results Test; it shows which rich results the page is eligible for.
  2. After publishing, monitor errors in Search Console's enhancement / rich result reports and the URL Inspection tool.
  3. 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.

Sources