BYTETOOLS

Speakable Schema Generator

Attach a speakable SpeakableSpecification to a WebPage or Article using CSS selectors or XPath, with duplicate and selector-type validation.

Page
Speakable sections
0
Selectors written
0
Duplicates dropped
cssSelector
Property used

Speakable JSON-LD

A SpeakableSpecification takes cssSelector or xpath, never both on the same node — the selector-type switch here enforces that. Google has documented speakable as a limited feature: it is used for news content read aloud by the Assistant, is restricted to publishers in certain regions, and adding the markup does not on its own make a page eligible. Mark up only 2–3 short sections, and avoid selectors that would read out a whole article.

What is the Speakable Schema Generator?

The Speakable Schema Generator adds a speakable SpeakableSpecification to a WebPage, Article or NewsArticle node.

  • WebPage, Article and NewsArticle output with the right title property for each
  • cssSelector or xpath, never both on the same node
  • Duplicate selectors dropped from the output and reported
  • Warns when a selector looks like the other syntax
  • Live counts of selectors written and duplicates removed
  • Copy as a script block or download the JSON file

How to use the Speakable Schema Generator

  1. 1

    Choose whether the page is a WebPage, Article or NewsArticle and enter its URL and title.

  2. 2

    For Article types, add the publication date and author.

  3. 3

    Pick CSS selectors or XPath, then list them one per line.

  4. 4

    Check the counters and any warning about duplicates or mismatched selector syntax.

  5. 5

    Copy the generated script tag into the page, or download the raw JSON.

About the Speakable Schema Generator

The Speakable Schema Generator adds a speakable SpeakableSpecification to a WebPage, Article or NewsArticle node. You list the CSS selectors — or XPath expressions — that point at the parts of the page worth reading aloud, and the JSON-LD is built around them.

The tool enforces the rules that trip people up: a SpeakableSpecification takes cssSelector or xpath, never both on the same node, so the selector type is a single switch. Duplicate selectors are dropped from the output and reported, and selectors that look like the wrong syntax for the type you chose are flagged.

Everything runs locally in your browser with nothing uploaded. Be realistic about what this markup does: Google documents speakable as a limited feature for news content read aloud by the Assistant, restricted to publishers in certain regions, and adding the markup alone does not make a page eligible.

Frequently asked questions

What does speakable schema do?

It marks the sections of a page that make sense when read aloud by a voice assistant, usually the headline and a short summary. Google introduced it for news content played back through the Assistant rather than as a general text-to-speech hint.

Can I use both cssSelector and xpath?

Not on the same SpeakableSpecification — you pick one addressing method. This generator makes that a single switch so the output can never contain both, which is one of the most common mistakes in hand-written speakable markup.

How many sections should be speakable?

Two or three short ones. Google's guidance is to mark up concise, self-contained content of around 20 to 30 seconds when spoken, so a headline plus a summary sentence works well and pointing at a whole article body does not.

Is speakable markup available to every website?

No. Google has documented it as a limited feature for news publishers in specific regions, and eligibility is not something markup alone can grant. Adding it does no harm and is valid schema.org, but treat any voice playback as a possibility rather than a promise.

What makes a good speakable selector?

One that targets a single, stable element containing text that stands on its own — an id on the headline, or a class on a summary paragraph. Avoid selectors that depend on fragile position rules, because they break the first time you change the template.

Related tools