Speakable content markup
speakable marks the sections worth reading aloud, which is what a voice agent reaches for first.
- Category
- Content accessibility
- Standard
- Emerging checkEmerging
- Off by default, turn on in settings
What it checks
The extension looks for a speakable property anywhere in the page’s JSON-LD.
Results
| Status | When |
|---|---|
| Pass | The structured data includes speakable |
| N/A | It does not |
How to fix
Add a speakable property to the page’s WebPage or Article node, with CSS
selectors pointing to the content a voice agent should read out:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebPage",
"name": "How to choose accounting software",
"speakable": {
"@type": "SpeakableSpecification",
"cssSelector": [".article-summary", ".article-headline"]
}
}
</script>
Related: Structured data (JSON-LD).