Structured Data - Change History & Alerts

Make sure you don't lose your Rich Results.

Sign up for alerts to stay on top of changes for Google Rich Result requirements and updates.

Structured Data Change History Timeline

Get these alerts in your inbox
February 2021

Clarification to Review snippet documentation

Google updated the Review snippet rich results documentation, changing the itemReviewed property to 'One of the valid types', where the valid types are listed underneath.

Previously this value was 'Thing', with the caveat that only the listed types are valid, so functionally nothing has changed here. However it suggests Google were seeing invalid markup where users were reading 'Thing' and not reading the rest, so it serves as a reminder to ensure your Review snippet markup is valid.


January 2021

Updated recommended property for Event rich results

Google updated the Event documentation to clarify the requirement for 'offers', which is one of the recommended properties.

For offers.priceCurrency, it now states that an ISO 4217 currency code must be used (e.g. USD). Previously, it simply stated '3-letter currency code', so this update mostly serves as clarification.


Instructions added on excluding paywalled content from search snippets

Google updated the documentation for paywalled content, to clarify that the guide only applies to content that you want to be crawled and indexed.

Notably, they also added a section 'Control what information is shown in search results', which explains how to exclude certain sections of content from appearing in search result snippets.



Price drop added as a potential enhancement for Product rich results

If you include a specific price (not a range) in your Product structured data, Google will now automatically calculate when a price has dropped (based on the running historical average of your product's pricing). In their example, Google show this as 'Price: $200 (typically $300)'.

Currently only available in the US, in English, on both desktop and mobile devices.


Job Training (beta) rich result currently not displaying

Job Training is currently in beta, and Google had previously stated that they were slowly rolling out coverage through the US.

The documentation has been changed to clarify that the appearance isn't available on Google Search right now - if you had previously seen Job Training results in Google Search, this will not be the case at the moment. They have not published a timeline for this to change.

December 2020

Google u-turn on deprecating the Structured Data Testing Tool

Following vocal support from the community, Google have reversed their decision to deprecate the Structured Data Testing Tool (SDTT). Instead, the tool will be 'refocused' and migrated to a new domain, by April 2021.

This new tool will be focused on checking syntax and compliance, but will NOT validate Google Search Features. Going forward, Google's recommendation will be to use their Rich Results Test for validating Google Search Features, and then separately using this new incarnation of the SDTT for validation against

November 2020

Schema v11.0 released

Changes to the Core section:

  • Fixed typo in description of ReceiveAction.
  • Fixed invalid JSON-LD in example #eg-0449 on VideoGame.
  • Removed redundant property definitions for upvoteCount & downvoteCount.
  • Fixed invalid term links identified in Examples files.

Additionally, changes made to the 'Pending' section.


Updated guidelines for Q&A rich result, for STEM related pages


Google added a new content guideline to the documentation for QAPage, relating specifically to pages about STEM education Q&As. Pages where the primary focus is to provide a correct answer to a user-submitted homework question may be eligible for a Q&A carousel experience. These pages may only have a single answer that's provided or selected by in-house experts (instead of users).
The docs also include an example: "An education page where a user submitted a single question, and a top answer is selected by experts."

October 2020

Google update sunsetting

Back in January, Google announced that markup will stop being eligible for Google search result features and enhancements. In April, they postponed the change due to the Coronavirus situation. Now they have updated their original blog post and supporting documentation to confirm they will be deprecating support for markup on January 29th 2021.


Updated required property value for the Library feed

For LibrarySystem, one of the required properties is 'additionalProperty.value', which must use one of 6 specific values. Google updated the documentation to replace 'national' with 'government.'

The allowed values are now:
  • public
  • academic
  • corporate
  • government (previously 'national')
  • school
  • special

Added image specification for logos on 3rd party job sites

Only applicable when dealing with a third-party job site, you can provide a different logo for a given organization than the image shown in the organization's Knowledge Graph card, by including the logo property in the hiringOrganization array.

Google updated the Job Posting documentation to add image ratio specifications to this property (hiringOrganization.logo); the image width and height ratio must be between 0.75 and 2.5.

September 2020

Shipping details support added as a potential enhancement for Product rich results

You can now add shipping costs and estimated delivery timeframes, which can appear in the Overview and Stores tabs for a specific product result. Currently only available in the US, in English, and on mobile devices.


Updated eligibility guidelines for Fact Check rich result

Updated the eligibility guidelines required to enable the Fact Check Rich Result, which now includes all relevant guidelines in one place (previously some of them were only mentioned in the Publisher Center article about fact-checked content).

Some new guidelines were also added:

  • You must have a corrections policy or have a mechanism for users to report errors.
  • Websites for political entities (such as campaigns, parties, or elected officials) aren't eligible for this feature.
  • You must clearly attribute the specific claim that you're assessing to a distinct second-party origin, whether it's a website, public statement, social media, or other traceable source.

Clarification to Review snippet documentation

Clarified that bestRating and worstRating are recommended properties if you want to specify a different scale than the default 5-point system. Previously they had been listed as required properties, but they were only required if the rating system is not a 5-point scale (which led to confusion).


Clarification to Employer Aggregate Rating documentation

Clarified that bestRating and worstRating are recommended properties if you want to specify a different scale than the default 5-point system. Previously they had been listed as required properties, but they were only required if the rating system is not a 5-point scale (which led to confusion).


New recommended property for Video rich result

Added regionsAllowed to recommended properties, which allows you to specify the regions in which the video is allowed. If not specified, then Google assumes the video is allowed everywhere.


Schema v10.0 released

Changes to the Core section:

  • Improve support for controlled taxonomies (e.g. SKOS) by supporting URLs into taxonomies for the keywords field: added URL and DefinedTerm as expected values.
  • SkiResort should be a subclass of Resort (in addition to the existing SportsActivityLocation supertype).
  • A parentItem of a Comment should be a Comment, not a Question.
  • The supertype of Question should be Comment, by analogy with Answer.
  • Changed description to reviewBody in a Review example.

Additionally, changes made to the 'Pending' section.

August 2020

Licensable image label out of beta

You can now obtain the 'Licensable' label on Google Images results by including the 'license' property.


Correction to required property for Video rich result

Correction to an error on the Video documentation page which stated that the required property 'thumbnailUrl' could either be ImageObject or URL, when actually it can only be a URL.


New Rich Result for Home Activities

To help people discover activities that they can do from home, you can now add structured data to your online event and video pages - for example for upcoming video livestreams or online events.


New structured data video & Rich Results FAQs

Google published a blog post with a video on how to get started with structured data, along with a set of FAQs on rich results and structured data.


Clarification to Article documentation for AMP and non-AMP pages

Clarified that there are different Article requirements for AMP and non-AMP pages. Added an example of a non-AMP page with Article structured data.


Clarification that images referenced in structured data must use a Google-supported file format

Updated all relevant documentation that images referenced in structured data must be in one of the image file formats that are supported by Google Images.


New recommended properties for Estimated Salary rich result

Updated the recommended properties for OccupationAggregationByEmployer to include the optional jobBenefits and industry properties.

July 2020

Clarification that multiple fact checks may not display in rich results

Google added a disclaimer to the Fact Check documentation to clarify that they are 'exploring ways to surface multiple fact checks. You may not see a rich result that features multiple fact checks in Google Search right away.'

Get Structured Data Alerts

We monitor all the Google and Schema docs so you don't have to. We'll email you an alert as soon as something changes, or just a monthly round-up.

By submitting your details you agree to Sitebulb's privacy policy (TL;DR we'll keep your data secure and won't ever sell it)