If you don't already know what Google Rich Snippets or schema.org are, this post is probably not for you.
Google Rich Snippets are not deprecated! The schema.org FAQ states, "If you have already done markup and it is already being used by Google, Microsoft, or Yahoo!, the markup format will continue to be supported. Changing to the new markup format could be helpful over time because you will be switching to a standard that is accepted across all three companies, but you don't have to do it."
This guide is for people who want to do it anyway.
Disclaimer: despite my working for Google, this guide has no official status. It represents nothing beyond my own personal interpretation, based on my experience writing about microdata and Google Rich Snippets in my free HTML5 book which you should totally pay money for because this is the way I want the world to work.
Some notes:
Table of Contents
§
is now
. Some properties have new names.
Old itemprop | New itemprop |
---|---|
street-address | streetAddress |
locality | addressLocality |
region | addressRegion |
postal-code | postalCode |
country-name | addressCountry |
§
is now
. There are no changes to property names or semantics.
Several properties in the old data-vocabulary.org
schema were of type . In the
schema.org
vocabulary, many of these now use a location
property of type Place. The new Place schema contains a geo
property of type GeoCoordinates.
§
is now
. The new schema has a number of more specific types like
Corporation
, NGO
, and SportsTeam
. Use the most specific type that is appropriate.
Some properties have new names or are expressed in different ways.
Old itemprop | New itemprop |
---|---|
tel | telephone |
geo | moved to |
§
is now
. Some properties have new names or are expressed in different ways.
Old itemprop | New itemprop |
---|---|
nickname | obsolete |
photo | image |
title | jobTitle |
role | obsolete |
friend , contact , acquaintance | obsolete, use knows , follows , or colleagues |
In addition, the affiliation
used to be a plain text property. It now takes an Organization. (See also: Organization changes)
§
is now
. The new schema has a number of more specific types like
BusinessEvent
, SocialEvent
, or Festival
. Use the most specific type that is appropriate.
Some properties have new names or are expressed in different ways.
Old itemprop | New itemprop |
---|---|
summary | name |
photo | image |
eventType | obsolete, use a specific event type if available |
geo | moved to location property |
In addition, the location
property used to be plain text or an Organization or an Address; now it must be either a Place or a PostalAddress. (See also: Address changes)
§
is now
. Some properties have new names or are expressed in different ways.
Old itemprop | New itemprop |
---|---|
category | obsolete |
review | reviews (type Review) |
offerdetails | offers (type Offer) |
identifier | productID |
The brand
property used to be plain text, but it now takes an Organization.
§
is now
. Some properties have new names or are expressed in different ways.
Old itemprop | New itemprop |
---|---|
itemreviewed | itemReviewed (type Thing) |
rating | reviewRating |
reviewer | author (type Person or Organization) |
dtreviewed | datePublished |
description | reviewBody |
§
is now
. Some properties have new names or are expressed in different ways.
Old itemprop | New itemprop |
---|---|
currency | priceCurrency |
condition | itemCondition (type OfferItemCondition) |
offerURL | url |
identifier | moved to productID property of itemOffered |
The availability
property used to be an enumerated attribute, but it now takes an ItemAvailability.
§