Remove deprecated schema

Rich result support changes. FAQPage is limited to authoritative government and health sites, HowTo rich results were retired, and data-vocabulary is obsolete. Remove markup for features you no longer qualify for, keep useful visible content, and check enhancement reports for items that stopped being valid.

mediumIn codeimpact effort

Why this matters

FAQPage limits and retired HowTo markup are maintenance debt.

Get the full breakdown

The extended brief explains when this works, when it does not, and the trade-offs. Join the waitlist and it unlocks for every tip when sign-in opens; MCP access is the paid part.

Join the waitlist

Before you start

  • An inventory of emitted JSON-LD types
  • Search Console enhancement reports

How to apply it

  1. Inventory emitted types General best practice

    Search templates for application/ld+json and list each @type with the template that emits it. Include plugin output.

    Check: The inventory lists every @type found in rendered pages with its template or plugin source.

  2. Remove ineligible markup

    Delete FAQPage and HowTo blocks where the feature is unavailable, and replace data-vocabulary types with schema.org equivalents.

    Check: Sampled pages no longer contain FAQPage, HowTo or data-vocabulary.org references.

  3. Re-validate and monitor

    Run the Rich Results Test on affected templates and check enhancement reports for new errors after removal.

    Check: Affected templates validate without errors and enhancement reports show no invalid items.

Get the prompt for your agent

A ready-to-paste prompt for your agent that implements this tip and verifies the result in your repo.

Join the waitlist

Source: seo-mcp playbook · curated entry · report an error

Framework notes

wordpress

Yoast and Rank Math emit FAQ blocks from their own settings; disable the FAQ schema toggle in the plugin rather than editing theme files.

nextjs-app

Search for `FAQPage` and `HowTo` strings in `app/**` and shared components, and delete the block and its data source together.

Official references

Let your agent apply this + 161 more tips.

Pre-order — $19