koira
Sign inGet access →
speakable schemavoice searchstructured data

Speakable Schema in Practice: Getting Voice Assistants to Read Your Content

KOIRA Team9 min read1,608 words
Diagram showing a webpage with a highlighted paragraph connected by an arrow to a voice assistant speaker icon, representing speakable schema markup in action
Intro
Breakdown
Solution
FAQ
◆ Key takeaways
  • Speakable schema uses CSS selectors or XPath to point voice assistants at the most answer-ready sentences on your page — not the whole page.
  • Google currently limits speakable schema eligibility to news publishers, but AI assistants and third-party voice platforms use it much more broadly.
  • The sections you mark as speakable should be written in plain, spoken-language style — short sentences, no jargon, no markdown artifacts.
  • You do not need a developer to add speakable schema; JSON-LD in your page's <head> is sufficient and editable in most CMS platforms.
  • Pairing speakable schema with FAQ schema and HowTo schema dramatically increases your chances of appearing in both voice and AI-generated answer surfaces.
  • Test every implementation with Google's Rich Results Test and validate the spoken output by asking your target question to a voice assistant directly.

The Problem Voice Search Has That Speakable Schema Solves

When a voice assistant answers a question, it doesn't read your whole page. It picks a few sentences — usually whatever its model considers the clearest, most direct answer — and reads those aloud. The problem is that without speakable schema, the assistant is guessing. It might pick your navigation text, a stray subheading, or a sentence buried in the middle of a dense paragraph that sounds terrible when read aloud.

Speakable schema fixes this. It's a structured data property — part of the Schema.org vocabulary — that lets you explicitly mark which sections of your page are written to be heard, not just read. Think of it as raising your hand and saying: "This part. Read this part."

If you've already read anything about voice search, you've probably seen speakable schema mentioned in a list of things to do someday. This post is about doing it today — specifically what the markup looks like, where to put it, and how to write the content that goes inside it.


What Speakable Schema Actually Is

Speakable schema is a property of the WebPage and Article Schema.org types. It accepts either CSS selectors or XPath expressions that point to the specific DOM elements on your page you want flagged as voice-ready.

Here's a minimal working example in JSON-LD:

{
  "@context": "https://schema.org/",
  "@type": "WebPage",
  "name": "What Is a Home Warranty?",
  "speakable": {
    "@type": "SpeakableSpecification",
    "cssSelector": [".speakable-intro", ".speakable-summary"]
  },
  "url": "https://example.com/home-warranty"
}

In plain English: you're telling the parser "find the elements with the class speakable-intro and speakable-summary — those are the sections optimized for audio delivery."

You can also use XPath:

"speakable": {
  "@type": "SpeakableSpecification",
  "xpath": [
    "/html/head/title",
    "/html/body/article/p[1]"
  ]
}

XPath is more precise but also more brittle — if your page structure changes, your selectors break. CSS selectors tied to stable class names are more maintainable for most small business sites.


Google's Official Stance (And Why It Doesn't Tell the Whole Story)

Google's documentation states that speakable schema is currently limited to news content and is only used in Google Assistant on certain Google Home devices. If you read that and thought "well, it's not for me," you'd be making the same mistake most SMB owners make.

Here's what that framing misses:

  1. AI overviews and generative search surfaces are pulling structured data from pages constantly. Google's own AI Mode, Bing Copilot, Perplexity, and others all index your structured data. Speakable schema signals content quality and answer-readiness in ways that matter to all of these systems — not just Google Assistant.

  2. The restriction is on which content Google will activate speakable schema for in its own voice product. It doesn't mean other platforms ignore the signal.

  3. Voice interfaces are proliferating faster than Google's documentation updates. Car dashboards, smart TVs, third-party assistants, and embedded voice features in apps all consume structured data. The speakable property has far more reach than Google's "news only" framing implies.

The practical reality: implementing speakable schema costs you very little time, and the upside — even partial — is real.


Writing Content That Actually Works When Spoken Aloud

This is where most implementations fail. Developers add the markup, but the text inside the marked elements was written for skimmers, not listeners.

Voice-ready content has specific characteristics:

  • Short sentences. Aim for 15–20 words maximum. Anything longer loses the listener.
  • No parenthetical asides. "(See section 4 below)" means nothing to someone hearing your page read aloud.
  • No relative references. "The table above shows..." — there is no table above when you're listening.
  • Active voice, present tense. "We repair HVAC units same-day" lands harder than "Same-day HVAC repair services are offered by our team."
  • Answer the question first. Don't build to the answer. Lead with it.

A good test: read your speakable section out loud to someone who hasn't seen the page. If they immediately understand the answer to the question the page is about, it's ready. If they ask a follow-up before they understand, rewrite it.


Where to Put Your Speakable Markup

Not every page warrants speakable schema. Prioritize:

1. Your FAQ page or FAQ sections These are already structured as question-answer pairs. Marking the answer text as speakable is a natural fit.

2. Service pages with a clear value proposition If someone asks "who does same-day plumbing in Austin," you want your service page's intro sentence to be the one the assistant reads. Mark it.

3. Blog posts that directly answer a question Posts structured around a specific question — "how long does X take," "what does X cost," "is X worth it" — are ideal candidates. Mark the first paragraph or the direct-answer summary block.

4. Your homepage hero text (with caution) If your homepage opening line clearly states what you do and who you serve, it can work. But generic taglines ("We deliver excellence") waste the opportunity.

What to skip: contact pages, gallery pages, product category listings, and any page where the content is primarily visual or navigational.


The Technical Implementation, Step by Step

If you're on WordPress, Squarespace, Wix, or most modern CMS platforms, you can add JSON-LD to individual pages without touching code at the template level. Here's how to think through the process:

Step 1: Identify your target pages. Start with three to five pages that answer specific questions your customers actually ask.

Step 2: Write or rewrite your speakable sections. Before touching any markup, make sure the text in question is genuinely voice-ready (see the criteria above). Bad content marked as speakable is worse than no markup at all — it trains AI systems to associate your domain with low-quality answers.

Step 3: Assign stable CSS classes. Add a class like speakable-answer to the exact HTML element (usually a <p> tag or <div>) that contains your voice-ready text. Don't use classes you're already using for styling — create dedicated semantic classes.

Step 4: Write your JSON-LD block. Use the WebPage or Article type and add the speakable property with a SpeakableSpecification pointing to your CSS class.

Step 5: Inject the JSON-LD into your <head>. Most CMS platforms have a "custom code" or "header scripts" field per page. Paste your JSON-LD there.

Step 6: Validate. Run the page through Google's Rich Results Test and Schema Markup Validator. Fix any errors before moving on.

Step 7: Monitor. Check Google Search Console's Enhancement reports over the following four to six weeks. Watch for manual actions or warnings, and track whether your pages begin appearing in voice-related featured snippets.


Combining Speakable with Other Schema Types

Speakable schema doesn't operate in isolation. The pages that consistently get surfaced in voice and AI answers tend to have layered schema implementations:

  • FAQPage schema marks individual questions and answers. Combined with speakable, the assistant knows both the structure and the audio-ready text.
  • HowTo schema structures step-by-step content. Marking the summary or intro as speakable means voice assistants can introduce the how-to before reading the steps.
  • LocalBusiness schema grounds your content geographically. If someone asks a voice assistant "who does X near me," your local business schema provides the context; your speakable markup provides the spoken answer.

If you're already running structured content with strong citation rates, adding speakable is the logical next layer — it's the bridge between being indexed and being spoken.


What "Good" Looks Like in 2026

The bar has moved. In 2022, having any schema markup put you ahead of most small business sites. In 2026, AI search surfaces have changed the entire dynamic — generative answers pull from structured, high-confidence content, and voice interfaces have become the default interaction mode in a growing number of contexts.

A well-implemented speakable page in 2026 looks like this:

  • The speakable section is the first full sentence after the H1, written as a direct answer
  • It is 40–80 words — long enough to be informative, short enough to be listenable
  • It contains your business name, your service, and your location or differentiator naturally
  • It is backed by valid JSON-LD with no schema errors
  • The rest of the page supports and expands the speakable answer, not contradicts it

That's not a high bar. It's just a bar that most businesses haven't bothered to clear.


The Honest Limits of Speakable Schema

Speakable schema is not a magic switch. A few things it cannot do:

  • It cannot force any voice assistant to use your content if your overall domain authority or content quality is low
  • It cannot compensate for a page that loads slowly or is not mobile-friendly
  • It does not guarantee Featured Snippet placement (though good speakable content often overlaps with featured snippet content)
  • It will not help pages that are blocked by robots.txt or noindex directives — the assistant can't read what it can't crawl

Treat speakable schema as one layer of a well-built content strategy, not a standalone fix. It rewards businesses that have already done the work of writing clear, direct, answer-first content — it just makes sure that content gets heard.


Final Thought

Every voice query is someone's hands-free moment — driving, cooking, working. They asked a question and they're waiting for an answer. Speakable schema is how you make sure the answer they hear is yours. The technical lift is minimal. The content discipline required is real. Start with your three most-visited pages, mark your clearest sentence on each one, validate the markup, and move on. That's an afternoon's work with a durable upside.

Every voice query is someone's hands-free moment — they asked a question and they're waiting for an answer. Speakable schema is how you make sure the answer they hear is yours.

Save this for later
Get a PDF copy of this post →
Drop your email, we’ll send you the full piece as a clean PDF. Plus the weekly KOIRA roundup.
Title: Speakable Schema in Practice: Getting Voice Assistants to Read Your Content
Speakable Schema
A Schema.org structured data property that uses CSS selectors or XPath to flag specific sections of a webpage as optimized for text-to-speech delivery by voice assistants and AI search engines.
SpeakableSpecification
The Schema.org object type used inside the speakable property to define exactly which page elements are voice-ready, via cssSelector or xpath values.
JSON-LD
JavaScript Object Notation for Linked Data — the recommended format for embedding Schema.org structured data in a webpage's <head>, used to implement speakable and other schema types without altering visible page content.
Voice Search Optimization
The practice of structuring and marking up web content so that voice assistants and AI-powered search engines can accurately identify, extract, and read aloud the most relevant answers to spoken queries.
CSS Selector (in schema context)
A pattern used within SpeakableSpecification to point the schema parser at specific HTML elements by their class, ID, or tag — telling voice assistants precisely which on-page text to treat as speakable.
Speakable Schema: Manual Content Guessing vs. Structured Markup Implementation
AreaNo speakable markupWith speakable schema
Which text gets read aloudVoice assistant guesses — often picks navigation text, a stray subheading, or a poorly worded mid-page sentenceYou specify the exact element: the clearest, most answer-ready sentence on the page
Content writing approachWritten for skimmers — long sentences, jargon, relative references that break down in audioWritten for listeners — short sentences, active voice, answer-first structure that works read aloud
Implementation complexityNothing to implement, but no signal sent to voice or AI platforms about content qualityOne JSON-LD block per page, CSS class on target element — doable in an afternoon without a developer
AI answer surface visibilityContent competes blind against structured pages; lower probability of citation in AI overviewsStructured signal increases confidence score for AI summarizers and voice interfaces pulling answer content
Schema validationNo validation needed — but also no data in Search Console about schema healthValidated via Google Rich Results Test; errors caught before they affect crawl interpretation
Compound schema benefitEach schema type (FAQ, HowTo, LocalBusiness) works in isolation with no audio-readiness signalSpeakable layers on top of existing schema types, amplifying the answer-readiness signal across all surfaces

How to implement speakable schema on a small business website

  1. 01
    Identify your three highest-priority answer pages. Pick pages that directly respond to a specific question — service pages, FAQ pages, or blog posts built around a single query. Skip navigational or visual-only pages.
  2. 02
    Rewrite or tighten your speakable section. Find the single paragraph that best answers the page's core question. Rewrite it to be 40–80 words, in active voice, with the answer in the first sentence. Read it aloud — if it sounds natural, it's ready.
  3. 03
    Add a stable CSS class to the target element. In your CMS or HTML editor, add a dedicated class — like speakable-answer — to the <p> or <div> tag wrapping your voice-ready text. Do not reuse styling classes; this class exists purely for schema targeting.
  4. 04
    Write your JSON-LD speakable block. Create a script block with type application/ld+json using the WebPage or Article schema type, and add a speakable property with a SpeakableSpecification pointing to your CSS class. Use the Schema.org speakable documentation as your reference.
  5. 05
    Inject the JSON-LD into your page's <head>. Paste the JSON-LD block into your CMS's custom header code field for that specific page. Most platforms — WordPress, Squarespace, Wix — expose this field at the page level without requiring developer access.
  6. 06
    Validate with Google's Rich Results Test and Schema Markup Validator. Run the live URL through both tools. Fix any errors flagged before moving to the next page — unresolved errors can cause the entire schema block to be ignored by crawlers.
  7. 07
    Monitor Search Console and test with a voice assistant. Check the Enhancement reports in Google Search Console over the next four to six weeks. Also manually ask your target question to Google Assistant or another voice interface to see whether your content surfaces — this is the ground truth test.
FAQ
Is speakable schema only for news websites?
Google's official documentation currently limits its own speakable schema activation to news content in Google Assistant. However, other AI-powered voice platforms — including Bing Copilot, Perplexity, and third-party voice interfaces — use the speakable property more broadly. For small businesses, the markup still sends meaningful signals about content quality and answer-readiness that extend well beyond Google's own narrow activation criteria.
How do I add speakable schema without a developer?
You can add speakable schema as a JSON-LD script block in your page's <head> section. Most CMS platforms like WordPress, Squarespace, and Wix have a 'custom code' or 'header scripts' field at the page level where you can paste JSON-LD directly. No template editing or developer access is required. The key steps are: assign a stable CSS class to your speakable paragraph, write the JSON-LD referencing that class, paste it into your page's header, and validate it using Google's Rich Results Test.
Which pages should I prioritize for speakable schema?
Start with pages that directly answer a specific question your customers ask: FAQ pages, service pages with a clear value proposition, and blog posts structured around a single question. Skip pages that are primarily visual or navigational, such as contact pages, gallery pages, and category listings. A good rule of thumb is to ask: 'If someone heard only the first two sentences of this page, would they know the answer to the question they came in with?' If yes, it's a speakable candidate.
What should the text inside a speakable section actually sound like?
Voice-ready text is short (15–20 words per sentence), written in active voice, and leads with the answer rather than building to it. Avoid parenthetical references, relative phrases like 'the table above,' and any markdown artifacts. The practical test is to read the section aloud to someone who hasn't seen the page — if they immediately understand the answer without follow-up questions, the text is ready to be marked as speakable.
Does speakable schema help with AI answer surfaces beyond voice?
Yes. AI overview features in Google, Bing Copilot, Perplexity, and similar generative search tools pull from structured, high-confidence content. Speakable schema signals to these systems that the marked content is concise, authoritative, and answer-ready — properties that align with what AI summarizers prefer to cite. It's not exclusively a voice optimization; it functions as a general answer-quality signal across AI-powered surfaces.
Can I combine speakable schema with FAQ and HowTo schema on the same page?
Absolutely — in fact, layering schema types is best practice. FAQPage schema structures your question-and-answer pairs, HowTo schema organizes step-by-step content, and speakable schema marks the audio-ready summary or intro text. These types are complementary and non-conflicting. Pages with multiple well-implemented schema types consistently outperform single-schema pages in both voice and AI-generated answer surfaces.
Written with AI assistance and reviewed by the KOIRA team before publishing.
Find KOIRA on
LinkedInCrunchbaseWellfoundF6S
Keep reading
Updates
AI Search Engines Changed This Quarter: Here's Exactly What Shifted and What to Do Now
9 min read
Data
The ROI of Structured Content: Citation Rates With and Without Schema
9 min read
Guides
Speakable Schema: What It Is and Why Voice Search Needs It
7 min read
Guides
Voice Search Optimization: Beyond Speakable Schema
8 min read
Stay in the loop
New posts, straight to your inbox.
Marketing and sales insights from the KOIRA team. No filler.
Speakable Schema in Practice: Getting Voice Assistants to Read Your Content
Get KOIRA