Speakable (Article
,WebPage
) structured data (BETA)
Thespeakable
schema.orgproperty
identifies sections within an article or webpage that are best suited for audio playback using
text-to-speech (TTS). Adding markup allows search engines and other applications to identify content
to read aloud on Google Assistant-enabled devices using TTS. Web pages withspeakable
structured data can use the Google Assistant to distribute the content through new channels and
reach a wider base of users.
The Google Assistant usesspeakable
structured data to answer topical news queries
on smart speaker devices. When users ask for news about a specific topic, the
Google Assistant returns up to three articles from around the web and supports audio playback using
TTS for sections in the article withspeakable
structured data. When the
Google Assistant reads aloud aspeakable
section, it attributes the source and sends
the full article URL to the user's mobile device through the Google Assistant app.
Example
The following is an example ofspeakable
structured data using JSON-LD code and the
xPathcontent-locator
value:
<html> <head> <title>Speakable markup example</title> <meta name= "description" content= "This page is all about the quick brown fox" /> <script type= "application/ld+json" > { "@context": "https://schema.org/", "@type": "WebPage", "name": "Quick Brown Fox", "speakable": { "@type": "SpeakableSpecification", "xPath": [ "/html/head/title", "/html/head/meta[@name='description']/@content" ] }, "url": "https:// example /quick-brown-fox" } </script> </head> <body> </body> </html>
Country and language availability
Thespeakable
property works for users in the U.S. that have Google Home devices
set to English, and publishers that publish content in English. We hope to launch in other
countries and languages as soon as sufficient number of publishers have implemented
speakable
.
Getting started
For your news content to be eligible as answers to topical news queries, follow these steps:
- Make sure that you followour guidelines.
- Add
speakable
structured data to your web page.
Guidelines
You must follow these guidelines forspeakable
content to be eligible to appear
in news results.
Technical guidelines
Follow these guidelines when implementingspeakable
markup for Google Assistant.
- Don't add
speakable
structured data to content that may sound confusing in voice-only and voice-forward situations, like datelines (location where the story was reported), photo captions, or source attributions. - Rather than highlighting an entire article with
speakable
structured data, focus on key points. This allows listeners to get an idea of the story and not have the TTS readout cut off important details.
Content guidelines
Follow these guidelines when writing content that you intend to mark up with
speakable
structured data.
- Content indicated by
speakable
structured data must 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, we suggest 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.
Structured data type definitions
Speakableis used by the
Article
or
Webpage
object.
The full definition ofspeakable
is available at
schema.org/speakable.You must
include the required properties for your content to be eligible for this feature.
Thespeakable
property can be repeated an arbitrary number of times, with two
kinds of possiblecontent-locator
values: CSS selectors and xPaths. Use one of
the following properties:
Required properties | |
---|---|
cssSelector |
Addresses content in the annotated pages (such as class attribute). Use either
"speakable": { "@type": "SpeakableSpecification", "cssSelector": [ ".headline", ".summary" ] } |
xPath |
Addresses content using xPaths (assuming an XML view of the content). Use either
"speakable": { "@type": "SpeakableSpecification", "xPath": [ "/html/head/title", "/html/head/meta[@name='description']/@content" ] } |
Troubleshooting
If you're having trouble implementing or debugging structured data, here are some resources that may help you.
- If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
- Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
- You might have an error in your structured data. Check the list of structured data errors and theUnparsable structured data report.
- If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues,use theManual Actions report.
- Review theguidelinesagain to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
- Troubleshoot missing rich results / drop in total rich results.
- Allow time for re-crawling and re-inde xing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and inde xing, check the Google Search crawling and inde xing FAQ.
- Post a question in theGoogle Search Central forum.
Can't trigger content
errorProblem:You can't trigger your content through the Google Assistant using TTS audio.
doneFix the issue
- Try the following voice commands:
- "What's the latest news about $topic?"
- "What's the latest on $topic?"
- "Play news about $topic."
- If you're still having trouble, it may be because ranking is determined algorithmically. The Google Assistant provides up to three articles from different news publications through TTS audio playback. For more information about how Google ranks articles, see How Search works.
More audio solutions
In addition tospeakable
structured data, you can use other Google Assistant
audio solutions for your news content, such as advanced integration of Google Assistant for
your own custom applications. For example, allowing users to interact with the app through
Google Assistant. For more information, see theActions on Google developer
guide.