# speakable

Indicates sections of a Web page that are particularly 'speakable' in the sense of being highlighted as being especially appropriate for text-to-speech conversion. Other sections of a page may also be usefully spoken in particular circumstances; the 'speakable' property serves to indicate the parts most likely to be generally useful for speech.

The *speakable* property can be repeated an arbitrary number of times, with three kinds of possible 'content-locator' values:

1.) *id-value* URL references - uses *id-value* of an element in the page being annotated. The simplest use of *speakable* has (potentially relative) URL values, referencing identified sections of the document concerned.

2.) CSS Selectors - addresses content in the annotated page, e.g. via class attribute. Use the [cssSelector](https://schema.org.ai/cssSelector) property.

3.)  XPaths - addresses content via XPaths (assuming an XML view of the content). Use the [xpath](https://schema.org.ai/xpath) property.

For more sophisticated markup of speakable sections beyond simple ID references, either CSS selectors or XPath expressions to pick out document section(s) as speakable. For this we define a supporting type, [SpeakableSpecification](https://schema.org.ai/SpeakableSpecification)  which is defined to be a possible value of the *speakable* property.

## Expected Types

| Type | Description |
|------|-------------|
| [SpeakableSpecification](https://schema.org.ai/SpeakableSpecification) | A SpeakableSpecification indicates (typically via [xpath](https://schema.org.ai/xpath) or [cssSelector](https://schema.org.ai/cssSelector)) sections of a document that are highlighted as particularly [speakable](https://schema.org.ai/speakable). Instances of this type are expected to be used primarily as values of the [speakable](https://schema.org.ai/speakable) property. |
| [URL](https://schema.org.ai/URL) | Data type: URL. |

## Used on Types

| Type | Description |
|------|-------------|
| [Article](https://schema.org.ai/Article) | An article, such as a news article or piece of investigative report. Newspapers and magazines have articles of many different types and this is intended to cover them all. See also [blog post](https://blog.schema.org/2014/09/02/schema-org-support-for-bibliographic-relationships-and-periodicals/). |
| [WebPage](https://schema.org.ai/WebPage) | A web page. Every web page is implicitly assumed to be declared to be of type WebPage, so the various properties about that webpage, such as `breadcrumb` may be used. We recommend explicit declaration if these properties are specified, but if they are found outside of an itemscope, they will be assumed to be about the page. |

---

Quoted from Schema.org 30.1, https://schema.org/speakable, under CC BY-SA 3.0. Served by the Org.AI Foundation at https://schema.org.ai/speakable.