SEOelinks field guide · information stewardship
Structured data is a public assertion about a page. Treat it like maintained business information: start with a verifiable fact, match it to visible copy, give it an owner, test the delivered page and never confuse valid markup with a promised search outcome.
Structured data is often introduced as a technical upgrade: select a type, fill in some fields, pass a test, and wait for a more prominent search result. That story leaves out the part that makes a small-business implementation trustworthy. Every property is also a statement about a real organization, a real page, a real offer, a real person or a real piece of visible content. Someone should be able to show where that statement came from, why it belongs on this page, who will correct it when it changes and what was checked after the site delivered it.
This guide is for a small business that already has—or is considering—markup on a WordPress or marketing website. It is not a catalog of every Schema.org type, a promise of rich results, an instruction to fill every plugin field or a substitute for a factual business review. Its purpose is narrower and more useful: create a calm decision process for public facts. That process protects customers from stale or invented information and gives the site team a better way to make deliberate changes.
Start with the fact, not the feature wish
Google describes structured data as a standardized way to provide information about a page and classify its content. The markup helps systems interpret the meaning of page information, but it does not turn an unverified idea into a fact. Google’s own general guidance says structured data must be a true representation of page content, should be current and original, and must not be misleading. [1] A sound implementation therefore begins with the underlying claim rather than a search-feature wish.
Suppose a team wants to add an opening-hours field, a review rating, a service area, a product price or an author identity. Each request is really a different factual question. Are the stated hours customer-facing and current? Is the rating derived from genuine user reviews that a visitor can find on the page? Is the service area a maintained operational statement rather than a keyword list? Does the price apply to the described offer, include the relevant conditions and remain current? Is the named author a real, visible contributor with a role the business can verify? The markup should not move ahead of those answers.
This approach changes the conversation in a helpful way. A developer can ask an operations owner for a source rather than guessing. An editor can add the same accurate information to visible copy before modeling it. A manager can choose not to add a field when its source is uncertain. None of those outcomes is a failure. Leaving an unresolved claim out is more responsible than publishing it in code simply because a plugin has a box for it.

Separate the vocabulary, the implementation and the Google feature
Three related ideas are frequently collapsed into one word: “schema.” The first is a vocabulary. Schema.org contains a broad language for describing things and relationships. The second is implementation: the page contains JSON-LD, Microdata or RDFa that expresses selected properties. The third is Google Search behavior: Google documents a specific set of structured-data features and the conditions that can make a page eligible for enhanced display. Those layers overlap, but they are not interchangeable.
Google says that most Search structured data uses the Schema.org vocabulary, while Google Search Central documentation—not the broader vocabulary—should be treated as definitive for Google Search behavior. It also notes that more objects and attributes exist in Schema.org than Google requires or uses for its documented features. [2] In practice, “this type exists” is not the same as “this page should add it,” and neither statement means that a particular visual treatment will appear.
Google’s structured-data gallery lists supported Search features such as Article, Breadcrumb, Local business, Organization, Product and several others. [3] The useful question for a small business is not which list is longest. It is whether the page genuinely contains the subject and required information that the documented feature describes. A service guide may be an article with a breadcrumb path. It is not automatically a product, an event, a course, a discussion forum or a page of customer reviews.
Vocabulary
A shared language for describing things. It can be broader than a search engine’s supported display features. Its existence does not decide what a page should say.
Implementation
Actual page markup. It must match the page, be syntactically sound, be delivered accessibly and remain maintainable when the visible source changes.
Documented feature
A Google-supported feature with its own required properties and content policies. Meeting a technical condition creates eligibility, not an assurance of appearance.
Public outcome
A search presentation is selected by Google. It should not be promised in sales copy, a project plan or a plugin scorecard.

Use the visible-page test before adding a property
The visible-page test protects both users and maintainers. Before adding or retaining a property, open the public page as an ordinary visitor. Identify the exact visible sentence, table row, byline, image, product detail, address, navigation path or customer content that supports the property. If the support exists only in an internal spreadsheet, a private CRM field, an assumed operating practice or an optimistic marketing note, it is not ready to be presented as page information.
Google explicitly warns against creating empty pages merely to hold structured data or adding markup for information that is not visible to the user, even when that information is accurate. [2] That does not mean a page must repeat raw JSON terminology. It means the user should be able to find the meaningful underlying information in the page experience. A visitor should not discover a price, review summary, hours or service claim only through a crawler-facing block.
Visibility also has a timing dimension. A fact may be true on the day it is supplied and stale by the day the page is published. A temporary offer may expire; a staff role may change; a location may stop seeing visitors; a price may depend on conditions that are absent from the page. In those cases, simplify the public claim, add the needed visible qualification or leave the property out until a stable, reviewable statement is available. This is ordinary editorial judgment, not lost optimization.
| Proposed statement | Evidence-led question | Safe next action |
|---|---|---|
| Business hours | Where can a visitor see current hours, and who confirms changes? | Add only when visible current information and a fact owner exist. |
| Review or rating | Are genuine user reviews shown, attributable and represented completely? | Do not invent or selectively model ratings; resolve the visible-content issue first. |
| Service or offer | Does this page actually describe the service, its fit and relevant conditions? | Model only the truthful, maintained page claim. |
| Image | Is the image relevant to the page and publicly crawlable? | Use the relevant durable image URL or leave the image property absent. |
| Author or organization | Can the business verify the identity and relationship shown to readers? | Use a visible, supportable attribution rather than an assumed credential. |

Choose the page’s main subject before modeling secondary details
A small-business page can contain several kinds of information: a guide may have an Article-like main subject, an author byline, an image, a breadcrumb path and a service-related call to action. That does not require every available type to be placed at the same level. Start by asking what the page is mainly for. Is it a guide, a service explanation, a contact route, a business identity page, a product detail or an event page? The answer should be obvious from the visible page, not reconstructed from code.
Google’s guidance advises including the main structured-data type that reflects the main focus of the page, while allowing multiple items where they describe user-visible information on that same page. [1] A breadcrumb can be useful alongside an article because both match the visible experience. A video can be related to a recipe when the page really has both. A collection of unrelated objects inserted because they might sound valuable creates a noisier, less defensible record.
This principle also helps when a page has a commercial call to action. A practical article can link to a service page without pretending that the article itself is a product offer. A contact page can identify the organization without claiming to be a physical branch or listing unavailable services. A local-business page should not borrow a city, address, opening status or rating merely because the business works in a wider market. The visible main purpose determines what the page may honestly describe.
When the purpose is unclear, pause before coding. Revise the visible page structure first: tighten the title, clarify the introduction, separate a service explanation from a generic blog post, or move a fact to the page where visitors expect it. Good markup often follows good information architecture. The distinct on-page SEO checklist covers broader page alignment; this guide is concerned with the more specific duty to keep the structured representation tied to that page’s actual purpose.
Build a small fact ledger rather than a long plugin checklist
Most small businesses do not need a large governance platform. They need a short shared record for the handful of claims that appear in markup. The record can live in an approved business document or issue tracker. What matters is that a person can trace each important claim back to a source and forward to a review action. This becomes especially useful when an editor, developer, marketing lead and operations owner each control a different part of the workflow.
For every claim, record the public page URL, the plain-language fact, the supporting visible copy, source of truth, person or team allowed to confirm it, markup type/property, last review date, trigger for revisiting it and public test completed after release. A line might say that an organization name comes from an approved legal/business identity source, is visibly present in the site header or about page, is maintained by the owner, and must be reviewed when the brand’s public name changes. A different line might say that a service description is controlled by the service owner and reviewed when the offering changes.
A ledger exposes uncertainty early. If nobody knows who owns a statement, the site has a maintenance risk. If a field has no visible copy, the page has an editorial gap. If the source is a discarded campaign document, the claim may need to be removed rather than copied forward. If multiple pages contain conflicting business facts, the priority is reconciling the public source—not adding more annotations around the conflict.

Make reviews, ratings, offers and local facts harder to add—not easier
Some fields deserve a higher proof threshold because customers can make decisions from them. Reviews and aggregate ratings are a clear example. Google’s quality guidance says not to mark up fake reviews or irrelevant/misleading content and notes that reviews or ratings that are not by actual users can lead to a manual action. [1] A star icon, an internally invented score, a testimonial without a genuine source or a selection of only the positive items is not a safe substitute for real user review content.
Offers and prices need similar care. A quoted amount can be useful only when a visitor can understand what it applies to, whether necessary conditions are present and how it stays current. A broad “starting at” claim without the actual qualification can create a misleading public expectation even if a code field is syntactically valid. When pricing varies by scope, a visible explanation of the estimate process may be more honest than a generic price property.
Local facts are not keyword fields. An address should describe a real, accurately represented place. A service area should describe a maintained operational reality, not a list generated to imply a local presence everywhere. Opening hours should correspond to the customer-facing operation that the page describes. The separate service-area business website strategy explains the broader difference between operating facts and location-page ambition; governance turns that distinction into a repeatable markup decision.
Images also need a source test. Google says an image specified in structured data should be relevant to the page and that image URLs must be crawlable and indexable. [1] A decorative generic stock image, a broken temporary link or an image unrelated to the described service is not improved by adding it to JSON-LD. Use a durable public image when it does the job; otherwise do not make it a structured assertion.
Give each change a sequence: source, copy, markup, test, record
A reliable update follows the direction of the evidence. First, confirm the business fact with the person who owns it. Second, revise the visible page so a normal visitor can understand the current statement and any meaningful qualification. Third, update the relevant markup in the implementation that owns it. On many WordPress sites this may be a Rank Math setting, a template, a theme or a controlled custom block; the location is less important than knowing which component is authoritative. Fourth, inspect the public rendered output. Fifth, record what changed and the evidence used.
This order prevents a common failure: code is changed first, then visible copy is left stale or contradictory. It also makes a rollback easier. If an operations owner corrects the source fact, the team can locate the visible text and structured representation from the ledger. If a template change accidentally strips JSON-LD or duplicates an item, the public check can identify the delivered difference rather than relying on an editor’s save state.
Work one group of facts at a time. A focused change might reconcile a business name, repair a single article image property or remove a no-longer-supported review fragment. It should not become a bulk “schema optimization” sweep that copies assumptions across unrelated pages. The relevant content refresh workflow uses a similar retain, revise, combine or defer mindset for content decisions. For structured data, defer is often the most careful option when the source fact cannot be verified.
Validate the delivered page, then observe rather than infer
Validation has layers. First, read the visible page. Does it make the same claim that the markup makes? Second, inspect the delivered HTML. Is the expected structured-data block present, parseable and tied to the correct public URL? Third, use appropriate technical checks such as the Rich Results Test and URL Inspection where the feature is relevant. Google says these tools can catch most technical errors. [1] A passed technical check is meaningful evidence about implementation, but it is not a promise about public search appearance.
After deployment, Search Console’s rich result reports can help monitor detected valid and invalid items for supported types. Google cautions that these reports are not a comprehensive list of all detected items; they are samples, and a report appears only when Google finds valid markup for a supported rich result type. [4] Treat that as monitoring information. It may reveal a template problem, a property issue or a need to inspect a representative URL. It should not be transformed into a statement that all pages are covered or that an appearance was assured.
Keep the evidence vocabulary precise. “The public page contains one valid JSON-LD block” is an observed technical fact. “The Rich Results Test found no critical errors for this feature” is a tool result. “Search Console reports valid items of a supported type” is a sampled report observation. None of these sentences means that Google will index the page, choose it as canonical, show a rich result, rank it higher, send more traffic or create a business result. Google controls those outcomes.

Test after a template, plugin or redesign change
Markup does not live separately from the page system. A theme change can remove a block. A plugin update can duplicate an organization entity. A migration can leave stale canonical URLs in JSON-LD. A redesigned article template can change visible copy while a global schema setting continues to describe the old structure. A new cache or optimization layer can deliver an earlier variant of a page. These are not reasons to avoid changes; they are reasons to include public structured-data checks in a release routine.
The practical release check can be short. Confirm the public response returns the intended page, the canonical reference is self-consistent where appropriate, the visible title and main heading still describe the page, expected JSON-LD parses, factual values match current visible content, image URLs load and internal paths work on desktop and mobile. The separate website redesign SEO checklist covers wider redesign preservation, while the broader technical SEO checklist places these checks alongside crawl, page and delivery foundations. A governance routine makes structured assertions one named item in that wider quality check.
Do not attempt to conceal a deployment problem with an extra layer of markup. If two plugins describe the same organization differently, identify the actual owner of the entity data and resolve the conflict. If a template omits essential visible information, fix the page before adding code. If a new page cannot support a property honestly, publish the clearer page without it. Simpler, maintained markup is more useful than a crowded collection of inconsistent objects.
Ask vendors and plugins accountable questions
A plugin can make an implementation easier; it cannot create the business facts it asks for. When choosing or reviewing a markup tool, ask where each output value comes from, whether it uses one identifiable source of truth, how visible-page changes stay synchronized, how it handles duplicate entity blocks, how it is tested after template updates and who has permission to change site-wide information. Ask for the public-page output, not only a dashboard screenshot.
Score labels deserve the same distance as any other generic indicator. A plugin may flag a recommended property, but it cannot determine whether the property is truthful, complete for the relevant feature, current for a customer or appropriate for that page’s purpose. Treat a score as a prompt to inspect the documented requirement and the source fact—not as an order to fill a field. This keeps the team from manufacturing copy merely to satisfy an interface.
Common decisions that deserve a deliberate “not yet”
A business does not need to solve every structured-data opportunity at once. Hold a proposed field when the source is disputed, the information is not visible, ownership is absent, conditions cannot be explained clearly, the page has no genuine main subject for the type or the team cannot commit to a review trigger. A temporary omission is reversible. A misleading claim can damage a customer’s understanding and create a harder cleanup.
Do not copy a property from a competitor, a generic checklist or an older page simply because it exists. Do not create a review, a rating, a price, a credential, an address, an image or a service claim to make markup look more complete. Do not use schema as a substitute for clarifying an ambiguous service page. Do not add a local-business object to a page that does not represent a real public business location. Do not describe an old campaign offer as a current offer because the code has not been revisited.
When the team is unsure, make the uncertainty visible internally. Put the item in the ledger with a status such as “needs owner confirmation,” “needs visible copy,” “not applicable” or “deferred.” This is more useful than letting a half-supported field silently pass from one redesign to the next.
A small-business structured-data governance check
- Name the visible public fact before naming the type or property.
- Link the fact to a current source and a person who can correct it.
- Confirm a normal visitor can find the meaningful information on the page that contains the markup.
- Use the main page purpose to decide what belongs in the model; do not add unrelated types for coverage.
- Give reviews, ratings, prices, locations, hours, images and credentials a higher proof threshold.
- Change source, visible copy and markup in the same controlled release sequence.
- Check delivered public HTML and appropriate testing tools after release, then record exactly what was observed.
- Do not convert technical validity, report visibility or plugin scores into ranking, indexing, rich-result, traffic or revenue claims.
Common questions
Does every page need structured data?
No. A page should have markup only when it can truthfully model the visible information it contains and the team can maintain the relevant facts. A generic desire for enhanced display is not a reason to add unrelated or unsupported objects.
Can valid JSON-LD guarantee a rich result?
No. A valid block can show that the implementation meets a technical condition. Google’s documentation describes eligibility requirements, but Google controls whether and how it presents results. Technical validation is not evidence of a promised display, index state, ranking or traffic outcome.
Should we add every recommended property our plugin shows?
Not automatically. Google advises complete and accurate recommended properties over a broad but incomplete or inaccurate implementation. Check the feature documentation, the visible page, the factual source and the maintenance owner before adding any property.
Can we mark up an accurate fact that is only in our internal system?
No. Google’s guidance says not to add markup for information that is not visible to the user, even if the information is accurate. Decide whether the fact belongs in visible page content first. If it does not, do not treat markup as a hidden outlet for it.
What should we do when two tools output different organization information?
Find the business source of truth and identify which template, plugin or controlled component owns the public entity. Reconcile the visible page and markup rather than leaving conflicting blocks in place. Then verify the public output after the change.
Keep markup in step with the business
Structured data is most useful when it behaves like the rest of a trustworthy website: it is based on facts, visible where readers need them, maintained by people who can verify changes and checked in the public version that visitors receive. That standard is less dramatic than filling every possible field. It is also more resilient. A small business can improve clarity one verified claim at a time without inventing proof or treating a tool result as a business promise.
When a page, offer, location, author, image or organizational fact changes, revisit both the visible page and its structured representation. When the fact is uncertain, resolve it before publishing or leave it out. When a technical check passes, record what it proves and what it does not. This gives a website a durable information-governance habit while leaving search crawling, canonical choice, indexing, presentation and ranking to the systems that decide them.
