---
title: "Speakable content markup · Sitebulb Labs"
description: "speakable marks the sections worth reading aloud, which is what a voice agent reaches for first."
url: https://labs.sitebulb.com/docs/checks/content-accessibility/speakable-content/
---

# Speakable content markup

speakable marks the sections worth reading aloud, which is what a voice agent reaches for first.

- Category

  [Content accessibility](https://labs.sitebulb.com/docs/checks/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:

```html
<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)](https://labs.sitebulb.com/docs/checks/content-accessibility/structured-data).