SpeakableSpecification

SpeakableSpecification is an Intangible used on Article / WebPage.speakable. Properties: cssSelector (Text — CSS selector for the speakable element) and xpath (Text — XPath alternative). It signals which DOM fragments are appropriate for text-to-speech rendering in Google Assistant / voice search.

Full example of schema.org/SpeakableSpecification json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/SpeakableSpecification

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NewsArticle",
  "headline": "Copenhagen Marathon sets 2026 course record",
  "speakable": {
    "@type": "SpeakableSpecification",
    "cssSelector": ["article h1", "article .lede"]
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid SpeakableSpecification entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/SpeakableSpecification (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SpeakableSpecification",
  "cssSelector": ["h1"]
}
</script>

Google rich results this unlocks

SpeakableSpecification is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). SpeakableSpecification becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common SpeakableSpecification mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
Using speakable on the whole article body
Wrong
```
cssSelector: "body"
```
Right
```
Narrow selectors: headline, lede, key-facts block
```
Speakable is for short passages suitable for voice rendering, not the full article.

Schema properties in this example

SpeakableSpecification Intangible speakable cssSelector xpath NewsArticle headline

Also mentioned in 4 other examples

SpeakableSpecification also appears in Article, BlogPosting, NewsArticle, and TechArticle. See the full SpeakableSpecification schema page for every reference.

About the example data

The speakable headline + lede on every Xoo Code news article.

Comments

Loading comments...