Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

SEO & AI search · Info

Yoast SEO Schema Settings Explained: What Each Option Does

Yoast SEO Schema Settings Explained: What Each Option Does

Short answer

Yoast SEO schema settings decide who your site represents, the default Page and Article types for each content type, and per-post overrides. Yoast turns these choices into one connected JSON-LD graph, so most sites only need to set site representation, logo and author details and keep the defaults.

Key takeaways

  • Site representation sets an Organization or Person as the publisher.
  • Each content type has default Page and Article types.
  • Per-post schema overrides live in the Yoast sidebar or meta box.
  • Author profiles feed the Person data for articles.
  • Test pages with the Rich Results Test and Schema Markup Validator.

What are Yoast SEO schema settings?

Yoast SEO schema settings control the structured data the plugin adds to every page, including who the site represents, the default page and article types for each content type, and per-post overrides.

Yoast builds this data automatically as one connected graph in JSON-LD format. It links your website, organization or person, each web page, the article on it, images and breadcrumbs.

You do not write schema code yourself. Instead, you answer a few questions in the settings, and Yoast uses those answers to describe your content to search engines.

The settings are spread across a few screens. This guide explains each one, what it changes and when you should touch it.

SettingWhere to find itWhat it controls
Organization or PersonSettings, Site representationWho publishes the site
Name, logo and profilesSettings, Site representationPublisher details in the graph
Default Page typeSettings, Content types, each typeWebPage subtype for that content
Default Article typeSettings, Content types, each typeArticle subtype for that content
Per-post Page and Article typeYoast sidebar or meta box, Schema tabOverride for a single post or page
Author detailsUser profilePerson data for authors

What does the Site representation setting do?

Site representation tells Yoast whether your site belongs to an organization or a person, and that choice becomes the publisher in your schema graph.

Go to Yoast SEO, then Settings, then Site representation. Choose Organization for a business, charity or brand, or Person for a personal blog or portfolio.

For an organization, add the organization name, an alternate name if you use one and a logo. For a person, select the WordPress user who represents the site, and Yoast uses that user's name and profile picture.

The same screen has fields for other profiles, such as social media pages. These go into the sameAs property, which helps search engines connect your site to those accounts.

Yoast's configuration guide walks through these fields during first setup. Our guide on setting up Yoast SEO covers the rest of the wizard.

What are the Content types schema settings?

Each content type, such as posts, pages and products, has a Schema section where you set the default Page type and Article type used for every item of that type.

Go to Yoast SEO, then Settings, then Content types, and open a type such as Posts. Scroll to the schema options.

Page type sets the WebPage subtype. The default is Web Page, and other options include About Page, Contact Page, FAQ Page, Profile Page, Search Results Page, Checkout Page and similar types from Schema.org.

Article type sets whether items are described as an Article and which kind. Posts usually default to Article, while pages usually default to None. Other choices include Blog Post, News Article, Tech Article and more.

Yoast's help page on choosing the Page or Article type explains each option. In most cases the defaults are right.

When should you change the default Article type?

Change the default Article type only when most content of that type clearly fits a more specific type, such as a news site using News Article for posts.

For a typical blog, Article or Blog Post both work well. Search engines treat them as close relatives, so the choice has little effect on rich results.

Set pages to None unless they really contain article-like content. A contact page or a product category page is not an article, and marking it as one adds noise to your graph.

For custom post types, think about what the content is. A recipe or event type is better served by a plugin or block that outputs those specific schema types.

Our guide on adding article schema in WordPress shows how Article data appears in search tools.

How do you change schema for a single post or page?

Open the post in the editor, go to the Yoast SEO sidebar or meta box, open the Schema tab and choose a different Page type or Article type for that item.

This override is useful for one-off pages. For example, set your About page to About Page, your Contact page to Contact Page and an FAQ page to FAQ Page.

The per-post setting only changes that item. The default for the content type stays the same.

If you use Yoast's FAQ or How-to blocks, Yoast adds the matching schema automatically. Our guide to adding FAQ schema in WordPress explains how those blocks work.

How do author settings affect schema?

Yoast uses each user's profile to describe the author of an article as a Person, including name, description, profile image and links to other profiles.

Go to Users, open a profile and fill in the biographical info and the contact or social profile fields Yoast adds. These details feed into the author entry in your schema.

Clear author information supports trust signals, especially for advice or review content. It costs little time to complete for every writer on the site.

What schema does Yoast add automatically?

Yoast automatically adds WebSite, WebPage, Organization or Person, Article where enabled, BreadcrumbList, ImageObject and a site search action, all connected in one graph.

Add-ons extend this. WooCommerce SEO adds richer Product data, Local SEO adds LocalBusiness details, and News SEO adds news-specific options.

Developers can add custom pieces to the graph or change existing ones with filters. Yoast's developer documentation on the Schema API covers this.

If you need schema types Yoast does not offer, such as Recipe or Event, use a specialized block or plugin that integrates with the Yoast graph. Our guide on adding schema markup to WordPress compares the options.

How do you test your Yoast schema?

Run a page through Google's Rich Results Test and the Schema Markup Validator to confirm the graph is valid and shows the types you expect.

The Rich Results Test shows which rich result features a page may qualify for. The Schema Markup Validator shows the full graph, including types Google does not use for rich results.

Look for duplicate data. If your theme or another plugin also outputs schema, you may see two Organization entries or two Article entries for the same page.

Google's structured data introduction explains that valid markup makes a page eligible for rich results but does not guarantee them.

How does Yoast compare with Rank Math for schema?

Both plugins build a schema graph automatically, but Rank Math gives more schema types and a visual schema builder in its free version, while Yoast keeps the settings simpler.

Yoast's approach is to set sensible defaults and only ask for a few choices. Rank Math lets you add multiple schema types to a single post from a library.

If you are weighing the two, our guide to Rank Math schema settings explains its options. Never run both plugins' schema output at the same time, or you will create duplicate graphs.

Do Yoast schema settings help rankings?

Schema settings do not directly raise rankings, but they help search engines understand your content and can make pages eligible for richer search results.

The main benefit is clarity. A clean graph tells search engines who publishes the site, what each page is and how pages relate.

Get the basics right, such as site representation, logo and author details, and then leave the defaults alone. Our article on whether structured data helps rankings covers the evidence in more detail.

Frequently asked questions

Where are schema settings in Yoast SEO?

Site-wide publisher details are under Yoast SEO, then Settings, then Site representation. Default Page and Article types are under Settings, then Content types, for each type. Single posts and pages have a Schema tab in the Yoast sidebar or meta box.

Should I choose Organization or Person in Yoast?

Choose Organization if the site represents a business, brand or group. Choose Person if it is a personal site, such as an individual blog or portfolio. The choice becomes the publisher in your schema graph.

Should pages use the Article type in Yoast?

Usually not. Most pages, such as contact, about or service pages, are not articles, so the Article type should be None. Use a specific Page type such as About Page or Contact Page where it fits.

Can I turn off Yoast schema output?

Yes, developers can disable it with a filter in code, but this removes the whole graph, including breadcrumbs and publisher details. It is better to keep Yoast schema and disable duplicate output from your theme or other plugins.

Does Yoast free include schema?

Yes. The free plugin builds the full schema graph, including WebSite, WebPage, Article, Organization or Person and breadcrumbs. Premium and add-ons such as Local SEO and WooCommerce SEO extend it with extra types and fields.

Sources

  1. The Page or Article type in your Schema settings Yoast
  2. Configuration guide for Yoast SEO Yoast
  3. Yoast SEO settings: Content types Yoast
  4. Introduction to structured data Google Search Central
  5. WebPage Schema.org
  6. Schema Markup Validator Schema.org

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.