Skip to main content

Fix Playbook

Publish citable, machine-readable facts

Replace vague claims with direct answers assistants can lift and cite.

Use this playbook when the report says services, service area, hours, pricing, eligibility, or trust facts are unclear.

What this fixes

  • The assistant guesses or hedges on basic business facts.
  • The site ranks or appears, but the answer cites a directory instead.
  • The business is mentioned but not recommended.
  • Buyer questions require calling because the page does not answer them.

Build fact modules

Create short, labeled sections that answer one buyer question at a time.

Fact moduleWhat to includeGood heading
Service scopeExact service names and exclusions"Services we provide"
Service areaCities, neighborhoods, ZIP codes, counties"Service area"
Hours and availabilityRegular hours, emergency hours, special hours"Hours and emergency availability"
Price or estimate policyPrice ranges, consultation fees, estimate method"How pricing works"
CredentialsLicenses, certifications, providers, languages"Credentials and licenses"
Next stepCall, book, quote, directions, order"Book or request a quote"

Rewrite pattern

Before

Our experienced team provides high-quality plumbing services with friendly technicians and fast response times.

After

ABC Plumbing provides emergency plumbing, drain cleaning, leak detection, and water heater repair in Austin, Round Rock, Cedar Park, Pflugerville, and Georgetown. Emergency service is available 24/7 by calling +1-512-555-0100.

Page checklist

  1. Answer the question in the first sentence. Do not make the assistant infer the answer from brand copy.
  2. Keep passages self-contained. Include the business, service, location, and condition in the same block.
  3. Use labeled facts. Tables, definition lists, and short bullets are easier to extract than long paragraphs.
  4. Add source context. Dates, licenses, providers, and policy details make claims more verifiable.
  5. Mirror key facts in structured data. Visible HTML is the source of truth; schema organizes it.

How to verify

Can the assistant quote the fact?

Ask the same buyer question again. A strong answer repeats the fact accurately and can point to the page that states it.

Re-run check

Related: Answerability, Citation confidence