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 · Guide

How to Edit Schema in WordPress (Step by Step)

How to Edit Schema in WordPress (Step by Step)

Short answer

To edit schema in WordPress, open the post, find your SEO plugin's Schema tab and change the type or fields there. Yoast lets you pick the Page and Article type, while Rank Math lets you edit each field. For changes no setting offers, a developer can use the plugin's schema filters.

Key takeaways

  • Test the page first to see what schema already exists.
  • Yoast edits schema through page and article types plus site settings.
  • Rank Math lets you edit every field in its Schema tab.
  • Remove duplicate schema from themes or extra plugins.
  • Retest in the Rich Results Test after every change.

How do you edit schema in WordPress?

You edit schema in WordPress through your SEO plugin's schema panel in the post editor, through its site-wide schema settings, or, for full control, with a code snippet that changes the JSON-LD output.

Schema markup is structured data that tells search engines what a page is about. In WordPress it is almost always added by a plugin, not typed by hand.

That means editing schema usually means changing plugin settings. You rarely touch raw code.

If you have not added any schema yet, start with our guide on adding schema markup to WordPress, then come back here to fine-tune it.

How do you find out which schema a page already has?

Run the page through Google's Rich Results Test or the Schema Markup Validator, which show every schema type on the page and which plugin or theme added it.

Before you edit anything, look at what is already there. Many sites output schema from two or three places at once.

  1. Open the Rich Results Test and enter the page URL.
  2. Note which rich result types Google detects and any errors or warnings.
  3. Open the Schema Markup Validator and test the same URL.
  4. Read the full list of types, including ones Google does not use for rich results.

The validator often shows the source. Yoast, for example, builds one connected graph, while some themes and review plugins add separate blocks.

If you see two Article or two Organization items, you have a duplicate. Fix that first, as described later in this guide.

How do you edit schema in Yoast SEO?

In the post editor, open the Yoast SEO panel, select the Schema tab and change the Page type or Article type; site-wide defaults live under Yoast SEO settings for each content type.

Yoast keeps schema simple on purpose. It builds the graph automatically and lets you pick the type per post.

Here is where each control sits:

  • Per post or page: the Schema tab in the Yoast sidebar or meta box.
  • Defaults per content type: Yoast SEO, then Settings, then Content types.
  • Organization or person details: Yoast SEO, then Settings, then Site representation.

Yoast's help page on the Page or Article type in your Schema settings lists the available types and when to use each.

To change the logo, name or social profiles in the schema, update Site representation. Those details feed the Organization or Person item that every page links to.

Our guide on setting up Yoast SEO covers the first-run settings that affect this graph.

How do you add custom schema with Yoast?

The free plugin does not offer a custom schema builder, so you either use Yoast's structured data blocks, such as the FAQ and How-to blocks, or a developer adds pieces through Yoast's schema filters.

The FAQ block outputs FAQPage markup for the questions you add. Our guide on adding FAQ schema in WordPress shows the block in use.

For anything beyond that, the Yoast developer documentation on schema describes the pieces and filters available to code.

How do you edit schema in Rank Math?

Open the post, click the Rank Math icon, go to the Schema tab, then click the pencil icon on an existing schema to edit its fields, or open the Schema Generator to add a new type.

Rank Math gives you more control in the editor than Yoast does. Each schema type has its own form.

  1. Open the post or page in the block editor.
  2. Click the Rank Math icon at the top right.
  3. Select the Schema tab.
  4. Click the edit icon beside the schema you want to change.
  5. Update fields such as headline, author, description or rating.
  6. Save the schema, then update the post.

Rank Math's guide to its custom schema generator explains each type and field.

Default schema for each post type is set under Rank Math, then Titles & Meta, then the post type tab. Changing it there affects new posts, not ones you already edited.

The page on Rank Math schema settings explains those defaults in more depth.

Can you use more than one schema type on a page?

Yes in Rank Math PRO, which lets you add several schema types to one post, while the free version is limited to one main type plus some block-based markup.

That matters for pages such as a recipe post that is also a review. Check Rank Math's current feature list before you buy, since plans change.

How do you remove or replace schema?

Delete the schema in your plugin's Schema tab, switch the type to none, or disable schema output from a theme or second plugin that is adding a duplicate.

Removing schema is just as common as adding it. Duplicates confuse validators and can hide the markup you care about.

Source of schemaHow to remove or change it
Rank MathSchema tab, then the delete icon on that schema
Yoast SEOChange the type in the Schema tab or content type settings
ThemeLook for a structured data option in the Customizer or theme panel
Review or recipe pluginTurn off its schema setting if your SEO plugin covers it
Hard-coded JSON-LDRemove the script from the template or snippet plugin

Rank Math has a help page on removing schema from posts and pages that covers both single posts and site-wide changes.

After removing a source, clear your cache and test the page again. Our guide on clearing cache in WordPress explains each cache layer.

How do you edit schema with code?

Add a small function through a code snippets plugin or child theme that hooks into your SEO plugin's schema filter, or print your own JSON-LD script in the page head.

Code is best for changes no settings screen offers, such as adding a property to every Article or building a custom type.

A plain JSON-LD block looks like this:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Co",
  "url": "https://www.example.com/"
}
</script>

Keep these rules in mind:

  • Use the filters your SEO plugin documents, so your changes join its graph instead of duplicating it.
  • Test on a staging site first. A broken snippet can take the site down.
  • Only mark up content that is visible on the page.

Google's introduction to structured data explains the general guidelines that apply to any markup you write.

If you add a snippet often, a staging site saves headaches. See our guide on setting up a staging site for WordPress.

Which schema fields are worth editing?

Focus on the fields that feed rich results or identify your site: headline, author, dates, images, organization name and logo, and type-specific fields such as price or rating.

Most defaults are fine. A few edits make the biggest difference:

  • Author: link it to a real person profile with a name and URL.
  • Publisher: set the correct organization name and logo.
  • Images: make sure the main image is large and relevant.
  • Dates: keep published and modified dates accurate.
  • Type: use the type that fits, such as BlogPosting, NewsArticle or Product.

Do not add review stars to your own business or invent ratings. Google's structured data policies treat misleading markup as spam.

For article-specific settings, read our guide on adding article schema in WordPress.

How do you check your edited schema?

Retest the URL in the Rich Results Test and Schema Markup Validator, fix any errors, then watch the enhancement reports in Google Search Console over the following weeks.

A green result in the test means the markup is valid. It does not guarantee a rich result, which Google decides case by case.

  1. Test the live URL after clearing cache.
  2. Fix errors first, then decide whether warnings matter for your type.
  3. Request indexing for the page in Search Console if the change is important.
  4. Check the relevant enhancement report a few weeks later.

Edit schema in small steps and test after each one. That way you always know which change caused a new error.

Frequently asked questions

Where is the schema setting in WordPress?

WordPress core has no schema setting. Schema comes from your SEO plugin or theme, so look for a Schema tab in the plugin's panel inside the post editor and for structured data options in the plugin's main settings.

Can I edit schema without a plugin?

Yes. You can add a JSON-LD script to your theme or through a code snippets plugin. This gives full control but needs care, because any mistake affects every page that uses the code.

Why does my page show duplicate schema?

Usually two sources output the same type, such as your SEO plugin and your theme, or an SEO plugin and a review plugin. Turn off schema in one of them and test the page again.

How long until Google shows my schema changes?

Google needs to recrawl the page first, which can take days or weeks. Requesting indexing in Search Console can speed this up, but rich results are never guaranteed even when markup is valid.

Does editing schema improve rankings?

Schema is not a direct ranking factor. It helps search engines understand the page and can make it eligible for rich results, which may improve how the listing looks and how often people click it.

Sources

  1. The Page or Article type in your Schema settings Yoast
  2. How to use Rank Math's custom schema generator Rank Math
  3. Removing schema from your posts and pages Rank Math
  4. Introduction to structured data markup Google Search Central
  5. Rich Results Test Google
  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.