Platform Guide · WordPress

Setting Up Schema in Yoast SEO

If your site runs Yoast SEO, most of your foundation schema is already being written for you. Your job is to give Yoast the right information, then fill in the gaps it leaves.

9 min readBeginnerWordPress + Yoast SEO

How Yoast thinks about schema

Yoast doesn't write a separate block for each type. It writes one connected graph on every page: your Organization (or Person), your WebSite, the current WebPage, its breadcrumbs, and, on posts, an Article and its author. Each piece points to the others by @id, just like the pattern in Lesson 2.

That's good news. You don't write any of that code. But Yoast can only describe what you tell it, so a site with blank settings gets a thin, sometimes wrong, graph.

Settings menus moveThe menu names below match recent versions of Yoast SEO (the redesigned Yoast SEO → Settings screen). If something has moved, use the search box at the top of the Yoast settings screen.

What Yoast covers (and what it doesn't)

This is the free Yoast SEO plugin. "Where it comes from" tells you which setting controls each piece.

Schema typeYoast?Where it comes fromLesson
Organization or PersonYesSettings → Site representation4, 11
WebSiteYesSettings → Site basics (website name, alternate name, tagline)5
WebPage and subtypes (AboutPage, ContactPage…)YesContent types defaults, plus the Schema tab on each page5
BreadcrumbListYesAutomatic, from your page hierarchy and categories6
ImageObjectYesYour logo and each page's featured image—
Article / BlogPostingYesPosts, using the Article type you choose9
Person (authors)YesEach author's WordPress user profile11
FAQPageWith blockOnly when you use the Yoast FAQ block10
HowToWith blockOnly when you use the Yoast How-to block—
LocalBusinessAdd-onYoast Local SEO (paid add-on)7
ProductAdd-onWooCommerce outputs its own; Yoast WooCommerce SEO connects it to Yoast's graph14
Service, Event, Recipe, ReviewNoAnother plugin (an events or recipe plugin) or your own JSON-LD8, 12, 13, 14

Two notes on the blocks. Google stopped showing FAQ rich results in 2026 and How-to rich results before that. The blocks still output valid markup and readable Q&A, but don't use them expecting extra space in Google.

Configure it in five steps

1. Run the first-time configuration

If you've never done it, Yoast has a guided setup (look under Yoast SEO → General). It walks through most of the settings below. Do it once, then check each setting yourself, because the details matter.

2. Site basics → your WebSite

Go to Yoast SEO → Settings → Site basics.

  • Website name: your brand name exactly as people say it. "Fern & Ink," not "Fern & Ink | Design + Letterpress Studio Minneapolis."
  • Alternate website name: a common short version or acronym, if you have one.
  • Tagline: one plain sentence. Yoast uses it as the WebSite description.

These feed the WebSite name and alternateName, which Google uses to choose the site name shown in search results.

3. Site representation → your Organization (or Person)

Go to Yoast SEO → Settings → Site representation. This is the most important screen.

  • Organization or Person: pick Organization for a business, studio, or agency. Pick Person only if the site really is about one individual (a personal portfolio, a solo creator brand).
  • Organization name: match your logo, footer, and Google Business Profile exactly.
  • Organization logo: upload a square-ish logo that reads on a white background. Google wants at least 112×112 pixels.
  • Other profiles: add the full URLs of your official social and directory profiles. These become sameAs. Only add accounts you control.
  • Extra organization details: recent versions also offer optional fields such as a description, contact details, and identifiers. Fill in only what's true and visible elsewhere on your site.

4. Content types → default page and article types

Go to Yoast SEO → Settings → Content types, open Pages and Posts, and find the Schema section.

  • Pages: leave the default Page type as Web Page. You'll set special pages one by one in step 5.
  • Posts: the default Article type is Article. If your posts are blog posts, Blog Post is a more accurate choice. Either is fine.
  • Custom post types (portfolio items, case studies) have their own settings here. A portfolio piece is usually just a Web Page.

5. The Schema tab → special pages

Open a page in the editor and find the Schema tab in the Yoast sidebar or the Yoast box below the content. Change the Page type only where it's clearly true:

  • About page → About Page
  • Contact page → Contact Page
  • Blog index, category, or portfolio listing → Collection Page

While you're at it, fill in each author's WordPress profile (Users → Profile): name, short bio, website, and the social profile fields Yoast adds. That's where the author Person on every post comes from.

See what Yoast is outputting

View the source of any page and search for yoast-schema-graph. You'll find one long line of JSON. Copy it into the Schema Markup Validator to read it as a tree. Here's a trimmed version of what a well-configured About page looks like:

JSON-LD · Yoast output, trimmed and formatted
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": ["WebPage", "AboutPage"],
      "@id": "https://fernandink.example/about/",
      "url": "https://fernandink.example/about/",
      "name": "About - Fern & Ink",
      "isPartOf": { "@id": "https://fernandink.example/#website" },
      "breadcrumb": { "@id": "https://fernandink.example/about/#breadcrumb" }
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://fernandink.example/about/#breadcrumb",
      "itemListElement": [
        { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://fernandink.example/" },
        { "@type": "ListItem", "position": 2, "name": "About" }
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://fernandink.example/#website",
      "url": "https://fernandink.example/",
      "name": "Fern & Ink",
      "description": "Brand identity and letterpress printing in Minneapolis.",
      "publisher": { "@id": "https://fernandink.example/#organization" }
    },
    {
      "@type": "Organization",
      "@id": "https://fernandink.example/#organization",
      "name": "Fern & Ink",
      "url": "https://fernandink.example/",
      "logo": {
        "@type": "ImageObject",
        "@id": "https://fernandink.example/#/schema/logo/image/",
        "url": "https://fernandink.example/wp-content/uploads/fern-ink-logo.png"
      },
      "sameAs": ["https://www.instagram.com/fernandink_example/"]
    }
  ]
}

Notice the @id values. Yoast uses your homepage URL plus #organization and #website, and the page's own URL for the WebPage. Write those down. They're how you'll connect anything you add next. (You may also see a SearchAction on the WebSite. It's harmless; Google retired the sitelinks search box it was for.)

Adding what Yoast doesn't cover

There are two clean ways to add a Service, Event, or anything else from the table above.

No code: a separate block that points to Yoast's

Add your own JSON-LD with a header-snippet plugin or your theme's header scripts box (see Lesson 3). The trick is to reference Yoast's Organization by its @id instead of describing it again:

JSON-LD · Service that connects to Yoast's graph
{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Letterpress Printing",
  "serviceType": "Letterpress printing",
  "url": "https://fernandink.example/services/letterpress-printing/",
  "provider": { "@id": "https://fernandink.example/#organization" },
  "areaServed": "Minneapolis–Saint Paul, MN"
}

Because the @id matches, search engines read this as "the same Fern & Ink from Yoast's graph offers this service." One business, not two.

For developers: the Yoast Schema API

If you're comfortable with PHP, Yoast has filters that let you change its graph directly, in a child theme's functions.php or a small custom plugin:

  • wpseo_schema_<piece> (for example wpseo_schema_organization) changes one piece.
  • wpseo_schema_graph_pieces adds your own piece to the graph or removes one.
  • wpseo_json_ld_output turns Yoast's schema off entirely, if you'd rather write it all yourself.
PHP · Add a property to Yoast's Organization
add_filter( 'wpseo_schema_organization', function ( $data ) {
    $data['areaServed'] = 'Minneapolis–Saint Paul, MN';
    return $data;
} );

The full list is in Yoast's Schema API docs.

Common mistakes

  • Two SEO plugins at once. Yoast plus Rank Math (or All in One SEO) means two competing graphs. Pick one.
  • A second Organization from the theme. Some themes and page builders add their own schema. If View Source shows two Organization blocks with different names, turn one off.
  • Blank Site representation. No logo, no profiles, and a name that doesn't match your Google Business Profile. Five minutes fixes this.
  • Choosing FAQ Page without questions. Only pages with visible questions and answers should be FAQ pages. The FAQ block handles this for you.
  • Turning Yoast's schema off and forgetting to replace it. If you disable it, you're responsible for Organization, WebSite, WebPage, and breadcrumbs.

Try it

Open your homepage source, find yoast-schema-graph, and paste it into the validator. Check three things: is the Organization name right, is there a logo, and does sameAs list your real profiles? Fix anything missing in Site representation, clear your cache, and check again.

Check yourself

  • Site basics has my real brand name and a plain tagline.
  • Site representation is set to Organization (or Person), with a logo and my real profiles.
  • Posts use Article or Blog Post; About and Contact pages use their page types.
  • Authors have filled-in WordPress profiles.
  • Only one SEO plugin outputs schema, and the theme doesn't add a second Organization.
  • Anything I add myself points to Yoast's #organization @id.
Go deeper

See how these foundation types fit together in Schema Markup Explained, Part 1 on Double Atari, and check Yoast's own guide to Page and Article types.