Yoast Schema Markup
Yoast schema markup is the structured data Yoast SEO adds to WordPress pages so search engines can better understand a site, page type, and content relationships.
- Also called
- JSON-LD structured data
- Applies to
- WordPress sites with Yoast SEO
- Commonly confused with
- visible schema markup or breadcrumb data
Key points
- Yoast schema markup is JSON-LD structured data that helps search engines understand page content and site identity.
- Correct configuration can improve eligibility for rich results such as article, FAQ, and HowTo display features.
- Setting the site representation as Organisation or Person in Yoast settings is essential for consistent schema output.
- Schema validation should be checked with Google Rich Results Test or Schema Validator after implementation.
- Schema markup is a signal for understanding, not a guarantee of enhanced rankings or rich results.
How it works
Yoast SEO generates JSON-LD structured data embedded in the HTML of each page. This data is not visible to users but is read by search engines to determine page type, content relationships, and site identity. The plugin uses site-wide defaults, defined in the Yoast settings under Site Representation, to build a schema graph that pages inherit and reference.
Content creators can override default schema for individual posts or pages using the Yoast metabox, where they can set the page type (e.g., Article, WebPage) and article type (e.g., NewsArticle, BlogPosting). Yoast also supports structured data blocks such as HowTo and FAQ, which can be added to content for eligible rich result use cases. For a broader understanding of how structured data interacts with other on-page elements, see the guide on rich content seo.
To implement schema correctly, site owners should ensure their site representation is set to Organisation or Person and that organisation name, logo, and author data are complete. The Yoast SEO WordPress plugin handles the technical generation, but the schema output must be validated with tools like Google Rich Results Test or Schema Validator. For more on schema fundamentals, refer to the article on seo schema.
Common mistakes
- Choosing the wrong site identity, such as using Person when the business should be Organisation, which can create inconsistent schema graphs.
- Leaving organisation name, logo, or author data incomplete, resulting in weak or broken schema output that may not qualify for rich results.
- Assigning schema types that do not match the actual page content, for example marking a landing page as an Article, which confuses search engines.
- Assuming schema automatically produces rich results without validating eligibility and markup quality; schema is only a signal, not a guarantee.
- Relying on outdated tutorials: Yoast's schema UI, default mappings, and supported blocks change across plugin versions, and Google's rich result eligibility also evolves.
Sources
- Yoast Help: Implementing schema with Yoast SEO Primary product documentation for how Yoast configures schema, site representation, and structured data blocks.[2]
- Google Search Central: Structured data Google’s official guidance on how structured data works and how it relates to search features.
- Google Search Central: Introduction to rich results Explains rich result eligibility and why valid markup does not guarantee display.
- Schema.org Canonical vocabulary reference for schema types and properties used in JSON-LD.
Written and maintained by Nora Lindholm. Last updated 27 July 2026.
Spotted an error? Email me — corrections are logged and credited on the entry. Outbound links are unpaid; most are nofollow.