Speakable Rich Results


Speakable markup’s intended use is to allow applications and search engines the ability to identify content on web pages best suited to be read aloud by Google Assistant enabled devices. The benefit is the ability to reach a wider base of channels and users. 

With speakable markup, Google will produce the audio playback of the webpage, attributes the source, and sends the full article URL to a user’s mobile device through the Google Assistant App. 

This markup is currently only supported for English speakers in the United States and publishers that publish in English. 

What does your webpage need? 

  • Your business website MUST be a Google-approved publisher. You can apply to be a publisher here:
  • Our software will look for the proper HTML items to mark up with speakable structured data. 
  • To assist our software, you can have your developer add the following to each article. 

1. cssSelector – Addresses content in the annotated pages (such as class attribute)

["headline", "summary"]

OR; But not BOTH 

2. xPath – Addresses content using xPaths (assuming an XML view of the content)


 Google’s Guidelines

  • Content indicated by speakable structured data should have concise headlines and/or summaries that provide users with comprehensible and useful information.
  • If you include the top of the story in speakable structured data, Google suggests that you rewrite the top of the story to break up information into individual sentences so that it reads more clearly for TTS.
  • For optimal audio user experiences, we recommend around 20-30 seconds of content per section of speakable structured data, or roughly two to three sentences.

For full documentation on speakable structured data visit: