wprichsnippets

Structured data: markup that machines read

A page is written once for people and labelled once for machines. This independent handbook explains how that label works in WordPress, how to check it, and what it does and does not do for rich results and AI answers.

Specimen · Review markup CERT No. WRS 0000 One block, two readers
Type
Review
Format
JSON-LD
Item
Recipe
Checked
JSON-LD · display only
1{2  "@context": "https://schema.org",3  "@type": "Review",14  "itemReviewed": { "@type": "Recipe", "name": "Example Recipe" },5  "reviewRating": { "@type": "Rating", "ratingValue": 4, "bestRating": 5 },26  "author": { "@type": "Person", "name": "Example Author" }37}
  1. 1What the thing is.
  2. 2How it was rated, and on what scale.
  3. 3Who stands behind it.
Read by a personExample search result
example.com › recipes › example-recipe
Example Recipe review
Example rating, not a real review: 4 of 5. Rating: 4 of 5 · Review by Example Author

The result a person may see. The stars come from line 5, if Google chooses to show them.

Eligible, never guaranteed.
Read by a machineExample AI answer

Example Recipe was reviewed by Example Author, who scored it 4 out of 5.example.com

Understood and named as the source. Whether an engine uses it is its own decision.

What is structured data?

Direct answerField 01

Structured data is code, usually JSON-LD, that labels what a page is, who wrote it and what it rates, so search engines and AI answer engines can read those facts without guessing. It makes a page eligible for features such as review stars, but it never guarantees that any engine will show or quote it.

Then stars, now answers

Field 02 · Compared
Rich results (then)Payoff: a richer listing
Who reads it
A person scanning a page of search results.
What it shows
Stars, price or cook time under the blue link.
What markup controls
Eligibility only; display stays the search engine's decision.
What it rewards
Valid markup that follows the feature's policies.
ExampleExample rating, not a real review: 4 of 5.Rating: 4 of 5
AI answers (now)Payoff: being understood
Who reads it
An answer engine assembling one reply from many pages.
What it shows
A sentence drawn from your page, with the page named as a source.
What markup controls
Clarity about what the page is; how much it counts is still an open question.
What it rewards
Markup that confirms a clear, quotable, honest page.
Exampleexample.comNamed as a source
Recently updated guides
Cert No.GuideSectionUpdated
ST 0001Review schema and review snippetsSchema types
ST 0005ItemList schema for ranked lists and tablesSchema types
AU 0004IPTC digital source type for AI imagesAuthenticity
ST 0002AggregateRating schema for user reviewsSchema types
ST 0003Local business schemaSchema types

Looking for the WP Rich Snippets plugin?

This domain once belonged to WP Rich Snippets, a premium WordPress plugin that added review and rating markup to posts and sold 14 add-ons. This site is an independent handbook. It is not the plugin, its developer or its successor, and it offers no downloads, licences or support. If you still run the plugin, the plugin record sets out its public history, maps each add-on to a current guide and lists the steps to move your markup to something you maintain.

Read the plugin record
Test procedure · On fileHow we check every guide
  1. 01

    Answer first

    Each guide answers its question in plain words before any code appears.

  2. 02

    Validate the code

    Each JSON-LD example is checked in the Rich Results Test and the Schema Markup Validator.

  3. 03

    Cite the source

    Each claim links to Google Search Central, schema.org, C2PA or IPTC text.

  4. 04

    Date it

    Published and updated dates sit in the label at the top of every guide.

  5. 05

    State the limits

    Each guide says plainly what the markup does not do.

Every guide follows the same procedure. The answer comes first, in plain words. Each JSON-LD example is checked in the Rich Results Test and the Schema Markup Validator, and the raw HTML of a page is inspected to confirm the markup is present without JavaScript. Claims link to Google Search Central, schema.org, C2PA or IPTC text, and every guide carries its published and updated dates. Read the full methodology.

Read the methodology

How the handbook is organised

Field 06 · Orientation

Start with a schema type

In Google's own words, structured data is a standardized format for providing information about a page and classifying the page content (Google Search Central, intro to structured data). Each kind of thing has its own vocabulary on schema.org: a review, a recipe, a local business, a product, a piece of software. The schema types section explains how each type works today, which properties matter and which ones still earn a visible result in search.

Most readers start with review schema and how star snippets work. Reviews and ratings were the job this domain was known for, and they are still where the rules are strictest: Google shows review stars only for certain content types, and never for a business praising itself.

WordPress how-tos

The WordPress section covers the practical side: adding JSON-LD with or without a plugin, turning old review boxes into clean markup, fixing WooCommerce product reviews and auditing what a schema plugin really prints. Each guide gives exact steps and example code you can adapt.

Before changing anything, learn to check the result. The Rich Results Test and the Schema Markup Validator answer different questions, and knowing which one to run, and what its warnings mean, saves a great deal of guesswork.

How do AI engines read markup?

AI Overviews, ChatGPT search and Perplexity now read many of the same pages that once competed for stars. Google states that there are no additional requirements to appear in AI Overviews or AI Mode and no special schema to add, while still asking site owners to make sure their structured data matches the visible text (Google Search Central, AI features and your website).

The AI answers section separates what is documented from what is guesswork, starting with whether schema markup helps AI Overviews at all. The short version: markup describes a page, and a clear page is what gets quoted.

Authenticity signals

Markup also carries trust: who wrote a page, when it last changed, whether its reviews are real and whether an image was made with AI. The authenticity section covers honest review markup, disclosing AI assistance, and image provenance labels such as C2PA Content Credentials and the IPTC digital source type.

Every guide in this handbook is dated, cites the primary documentation it relies on and says plainly what markup cannot do. Nothing here promises stars, rankings or citations, because no search engine offers them.