Pageoptimized
Module 05

On-page SEO

Improve titles, headings, snippets, body content, images, links, and valid structured data around a clear user task.

  • Business owners
  • Writers
  • SEO specialists
  • Agencies
Module case file

The Austin service page needs a clearer promise

Horizon Legal ranks for Austin injury queries, but the page must satisfy a person comparing local counsel, support a useful snippet, and use schema only where visible content supports it.

Page
/personal-injury/austin/
Primary task
Evaluate an Austin personal injury lawyer
Evidence needed
Local process, case fit, proof, fees, next step
QA sources
Rendered page, Site Health, Search Console
Your finished deliverable

Produce a page brief, title and snippet candidate, content/link changes, schema decision, and release checklist tied to this URL.

How this module works

The order matters

On-page work starts with the page's job, then improves search presentation and the experience that fulfills that job. Structured data describes eligible visible content; it does not replace the content.

  1. 01Define the promise

    State who the page serves, what it helps them do, and why it deserves a URL.

  2. 02Draft the search promise

    Align title and description candidates with the actual page.

  3. 03Fulfill the promise

    Improve evidence, utility, internal paths, and image meaning.

  4. 04Describe and verify

    Use supported markup and validate it against visible content.

Lesson 5.1

Define the page promise

State who the page serves, what it helps them do, and what evidence it must provide.

On-page work has a reputation for being a checklist, and the checklist version reliably produces pages that tick every box and help nobody. Title present. Headings in order. Keyword in the first hundred words. All true, all satisfied, and the page still loses to something written by a person who understood what the reader wanted.

The reason is that every item on that list is downstream of a decision most pages never make. Who is this for, what are they trying to finish, and what does this page provide that they cannot get from the four other pages already ranking?

That decision is the page promise, and it is worth writing as an actual sentence before anything else happens. Once it exists, most of the on-page checklist answers itself, because a title is easy to write when you know precisely what the page is for.

A title cannot rescue a page with no distinct purpose. Write the promise first and the page mostly writes itself.

What a page promise contains

Four parts, and none of them mentions a keyword:

  • Who it serves, specifically enough that you could picture one of them.
  • What it helps them finish, stated as their task rather than your content.
  • What evidence it provides that nobody else is providing.
  • What the next useful step is once the task is done.

The third part is where most pages fail. A page that restates what four competitors already say has no promise, whatever its title says, and no amount of on-page work changes that.

Write it as one paragraph and keep it at the top of the brief. Every later decision on the page gets tested against it: does this section serve the promise, does this link serve the promise, does this image serve the promise. Sections that fail that test are why long pages are often worse than short ones.

Claims need an owner before they need copy. Anything the page asserts that a reader could challenge, particularly on money, outcomes, timelines, or safety, needs a named person who can support it. Deciding that after the draft exists is how legal review turns into a rewrite.

The mental model

Every element repeats one promise

Title and description

The promise a person reads before they click.

  • Names the task, not the whole brand
  • Uses the language the query actually uses
H1 and opening

The same promise, repeated on arrival.

  • Says what the title said
  • Answers the task inside the first screen
Sections and evidence

The promise kept.

  • Covers the sub-tasks the result page shows people expect
  • Attributable evidence for consequential claims
Links and images

The promise extended to the next step.

  • Anchors that describe the destination
  • Images that carry information, with alt text that says it
Structured data

The same promise, restated for machines.

  • Only describes what a person can see on the page
  • Buys eligibility for an appearance, never a ranking

A mismatch between the title and the opening is the most common cause of a click that leaves immediately.

The page makes a promise in the result and keeps it on arrival. Most on-page work is removing a mismatch between two of these bands.

The Austin page does not estimate settlements

Horizon's Austin service page promises provider evaluation. Somebody is deciding whether this firm can handle their case, and the page has to carry local service details, case fit, fees, process, proof, and a way to start a consultation. That is a full page's work and it is a coherent one.

Settlement estimation is a different promise and it lives in the calculator. The temptation to fold it in is strong, because the query has volume and the topic is adjacent. Doing it produces a page that half-evaluates a provider and half-estimates a number, and a reader with either job finds a page that keeps interrupting itself.

Two promises on one page is the most common cause of a page that ranks and does not convert. It usually attracts the easier audience, which is the one further from buying, and then measures its own failure as a conversion problem. The fix is upstream, in module 3's format decision, not in more on-page work.

Inventory the page before you rewrite it

Before touching any wording, walk the page section by section and record four things about each one. This takes twenty minutes and it consistently finds the problem faster than reading the page as prose does.

Four columns, one row per section:

  • The heading level and its exact text, so you can see whether the structure is readable and whether any heading contains a word somebody would type.
  • The word count, which shows where effort actually went. Twelve use cases covered in 37 words is a finding on its own.
  • The job the section does for a reader, which separates good content sitting under a bad label from genuinely thin content.
  • Whether it is named after the company or after the reader's problem. Count the ratio.

That last column is the fastest diagnostic on a product page. A page with eleven sections where nine are named after the product or a claim about it has a labeling problem rather than a content problem, and those cost very different amounts to fix.

The pattern this exposes most often is right content under the wrong label: a section that genuinely defines what the product does, headed with a phrase from a positioning deck nobody has ever searched for. Reading the page top to bottom hides it, because the words underneath the heading are fine.

Write the promise

Four lines before any copy exists. If you cannot write them, the page is not ready to be written.

  1. Name the audience and their task.Carry it forward from the intent work in module 3 rather than inventing a new one here. A page whose audience disagrees with the map is a sign one of the two is wrong.
  2. State what this page provides that no other page does.Local detail, original data, a working tool, a process nobody else documents. If the honest answer is nothing, the page is a duplicate and the decision belongs back in the architecture.
  3. Name the next action.What a satisfied reader does next, which is not always a form. Sometimes the right next action is another page, and pretending otherwise produces a call to action everybody ignores.
  4. List the claims that need support.Assign an owner to each one now. Claims discovered during review are the ones that hold a page for two weeks while somebody finds a source.
Worked exampleSee the completed Horizon Legal work, then build your version.
Completed example: Horizon Legal

Austin page promise

The promise defines what the page must help a visitor accomplish.

Before this lesson: the approved page decision

URL
/personal-injury/austin/
Audience
Austin resident evaluating an injury claim
Observed need
Local fit, fees, proof, process, and next step
Constraint
No promise the firm or page cannot support

After this lesson: Finished output

Visitor
Austin resident evaluating a personal injury claim
Question
Can this firm handle my case, locally and credibly?
Evidence
Case types, Austin process, fee model, proof, attorney access
Next step
Request a confidential consultation
Decision

Every section must support evaluation or the next step; remove generic firm copy that does neither.

Save this in

Content Plan brief for /personal-injury/austin/.

Your turn

Use the principle on your own project

Follow the sequence once. The goal is a defensible decision, not completing steps for their own sake.

Have these open

The intent-to-page decision · The existing page, business facts, and evidence the page can truthfully provide

  1. Write the audience and task.
  2. State the page's unique value or evidence.
  3. Name the intended next action.
  4. List claims requiring support or expert review.
Reference notesDefinitions, site-specific paths, common mistakes, and completion paths

Terms in plain language

Use these definitions when a term is unfamiliar.

Page promise

A precise statement of who the page is for, what it will help them do, and what evidence it will provide.

Example

Help an Austin accident victim evaluate whether Horizon Legal fits their case using process, fees, local proof, and a clear next step.

Proof

Verifiable information that supports a page's claim instead of merely repeating promotional language.

Example

Named attorney credentials, documented process, cited rules, original data, product behavior, or specific case-selection criteria.

Primary action

The next useful step the page is designed to support after it answers the user's immediate task.

Example

Check case fit, start a consultation, compare plans, download a template, or continue to a related guide.

Choose the path that matches your site

New sites establish evidence; established sites use history.

Brand-new site or no usable history

Write one promise for every planned launch page before drafting. Base proof on real capabilities and approved sources, not traffic or conversion assumptions.

Site with usable history

Compare the intended promise with current queries, conversions, support questions, page content, and competing URLs. Fix mismatch before polishing metadata.

Common mistakes

What people often do and what to do instead.

Starting with keyword placement
InsteadStart with what the page must help a person understand or do.
Making a promise the page does not fulfill
InsteadAlign title, copy, evidence, and action with the real experience.

You should now have

  • A one-sentence page promise
  • Unique evidence or utility
  • Primary next action and success check

Before you move on, confirm

  • The page serves one primary task.
  • Claims have evidence owners.
  • The next action follows naturally.
Lesson 5.2

Write titles and snippet candidates

Help users recognize a relevant result without promising a fixed search appearance.

You do not control the title link on the result page and you do not control the snippet. Search systems generate both, using your title element, your headings, your visible content, and the query somebody typed. What you write is an input with real influence and no guarantee.

Accepting that changes what good work looks like here. The goal is not to author a fixed advertisement. It is to make the page trivially easy to identify and describe correctly, so that whatever gets generated is accurate and recognizable.

You supply inputs, not appearances. Write something true and specific, and let the generated version be right.

Writing an input rather than an advertisement

A title rewritten by the engine is not a failure. It usually means the engine found something on the page that matched the query better than your title did, which is information: either your title is vague, or the page is serving a query you did not write it for.

Both of those are worth investigating and neither is fixed by adding characters. Length rules are the most persistent superstition in this part of the job. There is a truncation width, it varies by device and query, and it is a presentation constraint rather than a ranking input.

What makes a title work

Six properties, in rough order of how much they matter, using Austin Personal Injury Lawyer | Horizon Legal as the reference:

  • It identifies this page and no other page on the site.
  • It uses the language of the task, which is usually the language of the query.
  • The distinguishing word comes early, because that is what survives truncation.
  • The brand appears where it aids recognition, which for a local firm is most of the time.
  • It contains no term repeated for weight rather than meaning.
  • It makes no claim the page cannot defend.

The stuffed alternative, Austin Injury Lawyer Best Accident Attorney Car Crash Lawyer, fails the first property outright. It could describe any page on the site, which means it identifies none of them.

Best is the claim worth removing. Unless a defensible comparison exists somewhere a reader can check, best is a word that costs nothing to write and provides nothing to believe. It also invites a comparison the page has not done and cannot win.

Actual PageOptimized screenUse the numbered steps with the product image below.
Free tool · Page Title Checker

Read the title a crawler actually receives

The checker fetches the live URL and reports the title element as served, its length, and a result preview. It reads the page rather than a database, so it shows what you shipped rather than what a tool last cached.

PageOptimized free Page Title Checker showing a page URL field, a check button, and the note that the tool performs a live URL fetch rather than using a paid SEO API.Open full size
  1. Enter the live URL rather than the staging one.
  2. Compare the returned title with the page promise from lesson 5.1.
  3. Treat the length reading as truncation risk, not a ranking rule.
  4. Check a sibling page for a near-duplicate title.

The description is a summary, not a pitch

A meta description earns its place when it summarizes what the page actually contains, in terms somebody scanning results would recognize. It gets used when it fits the query, and ignored when the page contains something that fits better, which is the correct behavior.

The failure mode is a description that promises something the page does not deliver. That produces a click, then an immediate return to the results, and it teaches everyone involved the wrong lesson. Duplicate descriptions across a template are a smaller version of the same problem: they make every page look identical at exactly the moment somebody is choosing between them.

Draft and check the metadata

Six checks, and the last two are the ones people skip because they require looking at other pages.

  1. Write the title from the page promise.The promise names the task and the audience, which is most of a good title already. Writing from the keyword instead is where stuffing comes from.
  2. Put the distinguishing word first.Whatever separates this page from its siblings should survive truncation. For a location page that is the location, not the service everyone else also offers.
  3. Align the visible heading with it.The H1 and the title should make the same promise. When they disagree, the engine has two candidate descriptions of your page and will pick whichever suits the query, which may not be the one you meant.
  4. Write a description that summarizes the real content.Describe what is there, including the specific thing nobody else has. A generic summary is a wasted opportunity to be chosen from a list.
  5. Check for duplicates across the template.Titles and descriptions that vary only by a swapped word are a template problem, not a copy problem, and they surface as a template fix in module 4's queue.
  6. Remove claims the page cannot support.Best, fastest, cheapest, and number one. Each one needs evidence on the page or it needs deleting, and deleting is usually faster.

Draft against the approved page promise

Use the real URL and visible promise. Preview length, but treat it as a presentation check rather than a guarantee that a search engine will use the text.

Horizon candidate
  • URL -> /personal-injury/austin/
  • Title -> Austin Personal Injury Lawyers | Horizon Legal
  • Description -> Understand your options after an Austin injury. Review case types, fees, timelines, and how to request a confidential consultation.
Reject these patterns
  • Austin Lawyer Injury Attorney Best Lawyer Texas Personal Injury
  • We are #1 and guarantee the best settlement
  • A description that mentions services or proof absent from the page
Worked exampleSee the completed Horizon Legal work, then build your version.
Completed example: Horizon Legal

Search presentation draft

The title and description make a clear promise without guaranteeing a rewrite-free snippet.

Before this lesson: the page promise from Lesson 5.1

Promise
Help an Austin resident evaluate counsel and act
Current page
/personal-injury/austin/
Primary topic
Austin personal injury lawyer
Review evidence
Current title, description, queries, and live results

After this lesson: Finished output

Title
Austin Personal Injury Lawyers | Horizon Legal
Description
Understand your options after an Austin injury. Review case types, fees, timelines, and how to request a confidential consultation.
Primary H1
Austin personal injury lawyers
Validation
Unique, accurate, visible promise; monitor actual query snippets
Decision

Publish the accurate candidate, then review Search Console CTR by the affected query cohort.

Save this in

Content brief and release note for the Austin page.

Your turn

Use the principle on your own project

Follow the sequence once. The goal is a defensible decision, not completing steps for their own sake.

Have these open

The page promise · Current title, description, query evidence, and competing result presentation

  1. Write a concise, specific title.
  2. Align the visible heading and page promise.
  3. Write a unique meta description that summarizes the useful content.
  4. Check duplicates, truncation risk, and unsupported claims.
Reference notesDefinitions, site-specific paths, common mistakes, and completion paths

Terms in plain language

Use these definitions when a term is unfamiliar.

Title element

The HTML title supplied by the page. Search systems use it as one input when generating a visible title link.

Example

Austin Personal Injury Lawyer | Horizon Legal is the supplied title, but the search result may display a variation.

Meta description

A page summary that may be used for a search snippet when it fits the query. It is not a fixed advertisement or direct ranking promise.

Example

Explain case fit, fees, and the next steps after an Austin accident.

Snippet

The descriptive text shown beneath a search result. It may come from the meta description or relevant visible page content.

Example

A search about fees may receive a snippet extracted from the visible fee section rather than the meta description.

Choose the path that matches your site

New sites establish evidence; established sites use history.

Brand-new site or no usable history

Draft unique titles and descriptions from each page promise, then verify that the visible heading and content deliver the same message after launch.

Site with usable history

Use current queries, title-link behavior, CTR segments, and page purpose to revise candidates. Do not rewrite every title because an aggregate CTR moved.

Common mistakes

What people often do and what to do instead.

Stuffing every keyword variation into the title
InsteadUse the clearest primary topic and differentiating context the page fulfills.
Treating a character limit as a guarantee
InsteadPreview likely truncation and remember search systems may rewrite snippets.

You should now have

  • Title and description candidates
  • Length and truncation review
  • A reason each candidate matches the visible page

Before you move on, confirm

  • The title identifies this page.
  • Description matches visible content.
  • No length score is treated as a ranking rule.
Lesson 5.3

Improve content, links, and images

Make the page understandable, navigable, and useful to its intended audience.

This is the part of on-page work with the worst folk wisdom attached. Keyword density, exact-match repetition, a target word count, and a rule about how many internal links a page should carry. None of these describe how a page becomes useful, and several of them actively damage it.

The useful version is simpler and harder. Answer the task early, cover the decisions the reader actually has to make, provide something original, and put links where somebody's job changes.

Coverage and clarity, not repetition. A page earns its place by containing something that is not available elsewhere.

Answer the task early

Somebody arriving on the Austin page wants to know whether this firm handles cases like theirs. Making them read four paragraphs of context before that becomes clear is a choice, and it is the choice most service pages make, usually because the page was written in the order the author thought about it.

Put the answer near the top and use the rest of the page to support it. This costs nothing in depth. A reader who is satisfied in the first screen and keeps reading is a reader who trusts the page, and readers who bounce from the first screen were never going to reach paragraph five.

Original evidence is the whole differentiator

Everything else on a page can be assembled from what already ranks. Original evidence cannot, and it is the only durable reason for a page to exist. It is also the part that gets cut first when a deadline moves.

Horizon's version is specific and cheap to produce. A short fee section written in plain terms, a claim-process diagram drawn from how the firm actually works, and case detail that shows familiarity with local courts. None of that requires research budget. It requires asking somebody in the business twenty minutes of questions.

The anti-pattern is six near-identical city paragraphs. It looks like coverage and adds nothing a reader in any of those cities can use, which is the same failure as the city-swap pages from module 3 happening inside a single page instead of across several.

Actual PageOptimized screenUse the numbered steps with the product image below.
Free tool · Image Alt Text Checker

Separate missing alt text from deliberate empty alt text

It counts images, missing alt attributes, and empty decorative alt from the live page HTML. The distinction matters: an empty alt on a decorative image is the correct answer, and a checker that flags it as a gap will send you to add noise.

PageOptimized free Image Alt Text Checker showing a page URL input and a description covering image counts, missing alt attributes, empty decorative alt text, and accessibility risk.Open full size
  1. Run it on a page carrying informative images.
  2. Confirm every informative image describes its role.
  3. Leave decorative images with empty alt rather than filling them.
  4. Fix the template when the same gap repeats across pages.

Links belong where the task changes

A contextual link earns its place when the reader's job is about to change. Three moments cover most of them:

  • They have enough to decide and need the next step, so link to the action.
  • They hit a sub-question the page will not answer fully, so link to the page that does.
  • They need a fact verified rather than asserted, so link to the source.

Anchor text should describe what is on the other side. Click here describes nothing, and an anchor stuffed with the target keyword describes the page you wish existed rather than the one you are linking to.

Links in navigation and footers are not contextual links and do not do this job. They are the same on every page, which means they cannot respond to where a particular reader is in a particular task.

Images that carry information

An image earns its place when it communicates something the text would take a paragraph to say. A diagram of the claim process qualifies. A stock photograph of a handshake does not, and it costs load time to say nothing.

Alt text describes the role, not the keyword. For the claim-process diagram, write what the diagram shows and why it matters, in a sentence a person listening to it would understand. Stuffing it with terms produces text that fails its actual audience while providing no benefit to the one people imagine it is for. Genuinely decorative images take empty alt text, which is the correct answer rather than a missed opportunity.

Filenames, dimensions, and captions are worth getting right for the same reason. A caption is read far more often than body copy, which makes it one of the most valuable places on the page to say something specific.

Improve the page

Seven passes over one page. Each one is a separate read, because trying to do them together means doing the easy ones and calling it finished.

  1. Move the answer to the primary task upward.Find where the page currently answers it and ask what the material above it is doing. Usually it is context the author needed and the reader does not.
  2. Organize the rest under descriptive headings.Headings that name the decision a reader is making, so somebody scanning can find their question. Clever headings cost the scanner time and buy nothing.
  3. Add the original evidence.The fee detail, the process diagram, the local specifics. This is the step that makes the page worth keeping, so it is the one to do before you run out of time rather than after.
  4. Cut the sections that do not serve the promise.Length is not coverage. A section that exists because a competitor has one is a section the reader scrolls past on the way to something they wanted.
  5. Place contextual links where the task changes.Then check each anchor describes its destination. Both halves matter, and the second one is where most link work quietly fails.
  6. Replace decorative images with informative ones.Or remove them. An image that communicates nothing is load time spent on nothing, which shows up later as a performance finding nobody can explain.
  7. Write alt text for a person who cannot see the image.That audience is real and specific, and writing for them produces better text than writing for a crawler that was never the intended reader.
Worked exampleSee the completed Horizon Legal work, then build your version.
Completed example: Horizon Legal

Page improvement specification

The change list is concrete enough for a writer and developer to ship.

Before this lesson: the approved promise and search presentation

URL
/personal-injury/austin/
Missing utility
Case-fit, fees, local process, and attorney proof
Useful destinations
Truck accidents, calculator, and consultation
Media rule
Alt text only when the image conveys information

After this lesson: Finished output

Add
Case-fit checklist, fee explanation, Austin process, attorney proof
Internal links in
Austin location hub; relevant case-result pages
Internal links out
Truck accidents; settlement calculator; contact
Images
Descriptive alt only where the image conveys information
Decision

Improve the existing URL; do not create a second Austin injury page.

Save this in

Content Plan task with section-level acceptance criteria.

Your turn

Use the principle on your own project

Follow the sequence once. The goal is a defensible decision, not completing steps for their own sake.

Have these open

The page promise and gaps found in result, customer, and site evidence · Relevant pages that should link to or from this page

  1. Answer the primary task early enough for the user.
  2. Organize supporting decisions under descriptive headings.
  3. Add original evidence, examples, or demonstrations.
  4. Link to relevant internal and trusted external resources.
  5. Add useful image dimensions, filenames, captions, and alt text.
Reference notesDefinitions, site-specific paths, common mistakes, and completion paths

Terms in plain language

Use these definitions when a term is unfamiliar.

Contextual internal link

A link placed where a related page helps the reader continue the current task, not merely in a global menu or footer.

Example

A fee explanation links to the detailed contingency-fee guide when the reader needs that detail.

Anchor text

The visible words used for a link. They should describe the destination naturally and accurately.

Example

Read how contingency fees work is clearer than click here or repeating an exact keyword everywhere.

Alt text

A text alternative that communicates an image's relevant information when the image cannot be seen. Decorative images can use empty alt text.

Example

Diagram showing the five steps in an Austin injury claim describes an informative process image.

Choose the path that matches your site

New sites establish evidence; established sites use history.

Brand-new site or no usable history

Build useful navigation and contextual paths into the initial content plan. Require informative images to have purpose and alternatives before launch.

Site with usable history

Use crawl evidence, user paths, orphan reports, and page tasks to repair missing or misleading links. Improve sections only where the task lacks information or proof.

Common mistakes

What people often do and what to do instead.

Adding words to reach a target length
InsteadAdd only information, proof, tools, examples, or decisions the audience needs.
Using generic anchors or decorative images without meaning
InsteadUse descriptive links and text alternatives that reflect the destination or image purpose.

You should now have

  • A section-level content change list
  • Internal link additions and removals
  • Image purpose and alt decisions
  • Evidence gaps that still need sources

Before you move on, confirm

  • Every section advances the task.
  • Links have descriptive context.
  • Alt text explains the image's role rather than stuffing terms.
Lesson 5.4

Use structured data within documented boundaries

Add eligible markup that matches the page instead of treating schema as an AEO switch.

Structured data has acquired a second, false reputation: that it is the switch you flip to get mentioned by AI systems. It is not, and treating it as one produces a specific kind of waste, because markup is cheap to add and its failure is silent.

Module 4 covered auditing schema that already exists. This lesson is about writing it, and the two constraints that decide whether it was worth writing at all.

Markup describes a page. It never improves one, and eligibility is not an appearance.

Choosing a type and filling it honestly

Pick a type that genuinely describes what the page is, and prefer the boring ones. Horizon uses Organization for identity and BreadcrumbList for navigation, both of which describe things a visitor can see, and both of which are stable across template changes.

Include the required properties, then the recommended ones that happen to be true. Recommended is not a target to hit. A property filled with something approximately accurate in order to complete a set is worse than an absent property, because it is a claim rather than an omission.

Match the visible page in meaning, not just in string. The facts in the markup have to agree with what a reader can find on the page. FAQ markup describing answers hidden behind an accordion nobody opens, or reviews that appear nowhere, is the version of this that draws manual attention.

Four things schema does not do

Each of these gets claimed regularly, and each one is worth being able to refute in a meeting:

  • It does not rank a page. It describes content for eligibility.
  • It does not guarantee a rich result. Content, policy, and quality requirements all still apply, and the appearance can be withdrawn.
  • It does not create AI citations. No documented mechanism connects markup to being named in a generated answer.
  • It does not repair missing content. Describing a calculator that fails to render produces an accurate description of a broken page.

Phrase the expected outcome as eligibility every time you report it. Shipping valid markup is completed work and belongs in the work layer of the measurement tree, not in the visibility layer, until an enhancement report shows something changed.

The fourth is the one that costs real money. A team ships markup for a feature whose underlying page is broken, the validator passes, the enhancement report stays empty, and six weeks disappear before anybody connects the silence to the rendering failure underneath it.

Actual PageOptimized screenUse the numbered steps with the product image below.
Actual product

Audit structured data beside the page

PageOptimized keeps schema findings attached to crawled URLs, visible content, and other page controls.

PageOptimized structured data audit showing detected schema types, validation status, and affected pages.Open full size
  1. Choose an eligible feature.
  2. Inspect detected markup.
  3. Compare it with visible content.
  4. Validate and monitor after release.

Why the citation belief persists

It is worth understanding where the myth comes from, because dismissing it without an explanation loses the argument in the room. Sites that get cited by answer engines do tend to use structured data. That correlation is real and it is not causal: both are downstream of being a well-built site run by an organization that maintains it.

Those same sites have clear headings, content that survives rendering, facts that agree across pages, and somebody responsible for keeping them current. Any one of those is a more plausible reason to be retrieved and quoted than a block of JSON in the head, and all of them take real work, which is precisely why markup looks attractive by comparison.

Add it because it describes your page accurately. That reason holds up on its own, requires no promise anybody has to keep, and survives the next time a vendor blog announces the mechanism has changed.

Markup fails silently, so give it an owner

Every other on-page element announces its own breakage. A missing title is visible. A broken image is visible. Structured data that stopped matching the page after a template change looks exactly like structured data that is working, from every angle except a validator nobody has run in eight months.

That makes it the one part of a page needing a scheduled check rather than an incidental one. Put the enhancement report on a review cadence and re-validate the affected templates whenever the front end ships a change to them. A property that quietly started emitting an empty string is not a small problem when the property is describing prices.

Add markup you can defend

Four steps, and the third is the one that separates useful markup from a liability.

  1. Confirm the feature is documented and the page qualifies.Start from the documented appearance you are trying to become eligible for, then work back to the type. Starting from the type produces valid markup for nothing in particular.
  2. Fill required properties, then true recommended ones.Stop when the true ones run out. Completeness is not the goal; accuracy is, and an approximated property is a claim you will have to defend.
  3. Read the markup against the rendered page.Every fact in it should be findable by a person looking at the page. Anything only present in the markup is a discrepancy waiting to be found.
  4. Validate, then watch the enhancement report.Syntax validation says the markup parses. The enhancement report over the following weeks is the only evidence about whether it did anything, and it is where a silently broken deploy shows up.
Worked exampleSee the completed Horizon Legal work, then build your version.
Completed example: Horizon Legal

Structured-data decision

Markup is selected from visible page content and documented eligibility.

Before this lesson: the visible page after content QA

Visible entity
Horizon Legal and its Austin service context
Visible path
Personal Injury > Austin
Candidate markup
Organization and BreadcrumbList
Boundary
No invisible FAQ or unsupported legal-service claims

After this lesson: Finished output

Organization
Use shared firm identity where accurate
BreadcrumbList
Use the visible Personal Injury > Austin path
FAQ
Do not add solely for rich-result promises
Validation
Syntax, required properties, visible-content agreement
Decision

Ship Organization and BreadcrumbList markup; omit unsupported legal-service claims.

Save this in

Release checklist and Site Health Structured Data tab.

Your turn

Use the principle on your own project

Follow the sequence once. The goal is a defensible decision, not completing steps for their own sake.

Have these open

The actual page type and visible entities · Current markup and the relevant search documentation

  1. Choose a type supported for the page and feature.
  2. Include required and relevant recommended properties.
  3. Match visible page content exactly in meaning.
  4. Validate syntax and monitor Search Console enhancements.
Reference notesDefinitions, site-specific paths, common mistakes, and completion paths

Terms in plain language

Use these definitions when a term is unfamiliar.

Schema type

A defined class in Schema.org used to describe an entity or content, such as Organization, Product, Article, or BreadcrumbList.

Example

A real product page may use Product; a law firm's service page should not pretend to be a product review.

Rich result

A documented search appearance that may be available when content, policy, technical, and markup requirements are met. Eligibility does not guarantee display.

Example

Valid product markup can make a page eligible for product-related appearances, but Google decides whether to show them.

Visible-content match

The facts in structured data must agree with information users can actually see on the page.

Example

Do not mark up an FAQ answer, review score, price, or author credential that is absent from the rendered page.

Choose the path that matches your site

New sites establish evidence; established sites use history.

Brand-new site or no usable history

Choose markup only after templates and visible content are final. Validate representative pages before launch and monitor template changes afterward.

Site with usable history

Inventory current markup by template, compare it with rendered content and documented features, then fix errors and misleading eligibility assumptions.

Common mistakes

What people often do and what to do instead.

Adding schema for content users cannot see
InsteadKeep markup consistent with visible, current information.
Promising a rich result after validation
InsteadDescribe validation as eligibility, not a display guarantee.

You should now have

  • Valid JSON-LD or a documented no-markup decision
  • Visible-content match
  • Validation and post-release check

Before you move on, confirm

  • The feature is documented.
  • Markup matches visible content.
  • The expected outcome is phrased as eligibility, not a guarantee.
Primary references

Verify the practice at the source.

Practices and source links reviewed August 2026.