Rich Pins

Make your product, recipe, movie, article or place Pins more useful.

Updated Decemeber 18th, 2013

How to apply for Rich Pins:

  1. Decide what kind of Rich Pin (product, recipe, movie, article or place) you want to apply for
  2. Read the documentation below
  3. Add the appropriate metatags to your site
  4. Validate your Rich Pins and apply to get them on Pinterest

Want to opt out of Rich Pins?

Product Rich Pins

For products we support two collection methods: oEmbed and semantic markup (Schema.org and Open Graph).

Which method is best for you?

  • oEmbed

    If you have technical capabilities to set up an oEmbed endpoint — this is the preferred and most flexible method.

  • Semantic Markup

    If you currently support Schema.org or Open Graph metatags, or if you can’t set up an oEmbed endpoint but can easily modify your product page templates to include price and availability metatags.

oEmbed

oEmbed is very flexible: it can support multiple products on one page and it is easy to keep the information up to date. oEmbed allows Pinterest to look in one canonical place for pricing and availability information, and guarantees that we will always get it right. More information: http://oembed.com/

To see a working example of an oEmbed endpoint that handles product information, take a look at the endpoint for etsy.com: http://openapi.etsy.com/svc/oembed. Try any Etsy product URL to see an example of a JSON response. For example: http://openapi.etsy.com/svc/oembed/?url=http%3a%2f%2fwww.etsy.com%2flisting%2f128235512%2fetsy-i-buy-from-real-people-tote-bag

Keep in mind that standard oEmbed endpoints must support a url query parameter.

Basic format for single product pages

If your product pages contain only one product, you can use this format.

Supported fields:

Field Description Required?
url String, canonical URL for the page (for example "http://www.etsy.com/listing/83934917/chocolate-raspberry-drizzle-body-lotion") Y
title String, product name. May be truncated, all formatting and HTML tags will be removed. Y
price Number (float), product price (without currency sign, for example "6.50"). Y
currency_code String, currency code as defined in http://www.xe.com/iso4217.php (for example "USD"). Y
provider_name String, store name (for example "Etsy"). N
description String, product description. May be truncated, all line breaks and HTML tags will be removed. N
brand String, brand name (for example "Lucky Brand"). N
product_id String, ID that uniquely identifies the product within your site. N
availability Case-insensitive string, possible values: "in stock", "preorder", "backorder" (will be back in stock soon), “out of stock” (may be back in stock some time), “discontinued.” Discontinued items won’t be part of a daily scrape and marking them will decrease the load on your servers. N
quantity Number (int). Positive value is interpreted as "in stock", "out of stock" otherwise. N
standard_price Number (float). Product's original price if it's on sale (without currency sign, for example "10.00"). N
sale_start_date If the product is on sale, the start date in ISO 8601 date format. N
sale_end_date If the product is on sale, the end date in ISO 8601 date format. N
product_expiration Product expiration date in ISO 8601 date format. N
gender Gender property of this product can only be 'male', 'female' and 'unisex'. N
geographic_availability The list of product available geographic areas in ISO 3166 Country Code format. Can be 'All' if applies for all countries. N
color List of color specs (in JSON format) if the product has different colors. you can specify the color's name, detail image, and standard color map name(must be one of 'beige', 'black', 'blue', 'bronze', 'brown', 'gold', 'green', 'gray', 'metallic', 'multicolored', 'off-white', 'orange', 'pink', 'purple', 'red', 'silver', 'transparent', 'turquoise', 'white', or 'yellow'). Please see sample oEmbed response below for full format. N
images List of URLs of high resolution images for this product. Up to 6 images can be provided. N
related_items List of URLs (must be the same domain) representing the related productsi. N
referenced_items List of URLs representing the referenced other products. N
rating Number (float), rating of this product (for example, 4.6). N
rating_scale Number (int), maximum value of the ratings scale. Required if rating provided (e.g. 5). N
rating_count Number (int), rating count of which the product is rated(e.g. 113). N

Sample oEmbed response

Here’s a sample oEmbed response for this product: shop.famsf.org/do/product/BK5160:

{
    "provider_name": "FAMSF",
    "url": "http://shop.famsf.org/do/product/BK5160",
    "title": "de Young Copper Bookmark",
    "description": "Our signature bookmark derived from the de Young's
                    unique architecture and copper exterior. Measures
                    5 3/4'' x 1 1/4''. FAMSF Exclusive.",
    "product_id": "BK5160",
    "price": 15.00,
    "currency_code": "USD",
    "availability": "in stock",
    "standard_price": 20.00,
    "sale_start_date": 2013-12-20T00:00:00,
    "sale_end_date": 2013-12-31T00:00:00
    "gender": "unisex",

    "images": ["http://shop.famsf.org/storeImages/images/store/CPG-RP_l.jpg",
               "http://shop.famsf.org/storeImages/images/store/CPG-RP_02_l.jpg"]

    "rating": 4.0,
    "rating_scale": 5,
    "rating_count": 112,

    "related_items":["http://shop.famsf.org/Product.do?code=CPG-RP", 
                     "http://shop.famsf.org/Product.do?code=HW1S01"],

    "color":[{"name": "Aqua", "http://shop.famsf.org/storeImages/images/store/CPG-RP_l.jpg", "map": "blue"},
             {"name": "amber", "http://shop.famsf.org/storeImages/images/store/CPG-RP_02_l.jpg", "map": "orange"}]

}
        

Format for pages with multiple products or multiple offers (or "skus")

Use this format if your product pages can contain multiple products on one page (for example: pajama top and bottom) or products with multiple offers / skus (for example: pajama bottoms in different colors that have different prices).

Supported fields:

Field Description Required?
url String, canonical URL for the page (for example "http://www.etsy.com/listing/83934917/chocolate-raspberry-drizzle-body-lotion") Y
products JSON list of dictionaries with product fields as defined below. Y
provider_name String, store name (for example "Etsy") N

Product fields:

Field Description Required?
title String, product name. May be truncated, all formatting and HTML tags will be removed. Y
offers JSON list of dictionaries with offer fields as defined below. Y
description String, product description. May be truncated, all line breaks and HTML tags will be removed. N
brand String, brand name (for example "Lucky Brand"). N
product_id String, ID that uniquely identifies the product within your site. N
images List of URLs of high resolution images for this product. Up to 6 images can be provided. N
gender Gender property of this product can only be 'male', 'female' and 'unisex'. N
product_expiration Product expiration date in ISO 8601 date format. N
color List of color specs (in JSON format) if the product has different colors. you can specify the color's name, detail image, and standard color map name(must be one of 'beige', 'black', 'blue', 'bronze', 'brown', 'gold', 'green', 'gray', 'metallic', 'multicolored', 'off-white', 'orange', 'pink', 'purple', 'red', 'silver', 'transparent', 'turquoise', 'white', or 'yellow'). Please see below sample oEmbed response for full format. N
related_items List of URLs (must be the same domain) representing the related products. N
referenced_items List of URLs representing the referenced other products. N
rating Number (float), rating of this product (for example, 4.6). N
rating_scale Number (int), maximum value of the ratings scale. Required if rating provided (e.g. 5). N
rating_count Number (int), rating count of which the product is rated(e.g. 113). N

Offer fields:

Field Description Required?
price Number (float), product price (without currency sign, for example "6.50"). Y
currency_code String, currency code as defined in http://www.xe.com/iso4217.php (for example "USD"). Y
title String, product name. May be truncated, all formatting and HTML tags will be removed. N
description String, product description. May be truncated, all line breaks and HTML tags will be removed. N
offer_id String, ID that uniquely identifies the offer within your site. N
availability Case-insensitive string, possible values: "in stock", "preorder", "backorder" (will be back in stock soon), “out of stock” (may be back in stock some time), “discontinued.” Discontinued items won’t be part of a daily scrape and marking them will decrease the load on your servers. N
quantity Number (int). Positive value is interpreted as "in stock", "out of stock" otherwise. N
standard_price Number (float). Product's original price if it's on sale (without currency sign, for example "10.00"). N
sale_start_date If the product is on sale, the start date in ISO 8601 date format. N
sale_end_date If the product is on sale, the end date in ISO 8601 date format. N
geographic_availability The list of product available geographic areas in ISO 3166 Country Code format. Can be 'All' if applies for all countries. N

Sample oEmbed response

Here's a sample oEmbed response for this product page that contains one product with multiple offers (or "skus"): http://www.zappos.com/puma-kids-speeder-illuminescent-v-infant-toddler-youth-limestone-gray-twilight-blue-flame-scarlet :

{
    "provider_name": "Zappos",
    "url":
        "http://www.zappos.com/puma-kids-speeder-illuminescent-v-infant-toddler-youth-limestone-gray-twilight-blue-flame-scarlet",
    "products":
       [{
        "title": "Puma Kids Speeder Illuminescent V",
        "brand": "Puma",
        "product_id": "SKU 7587775",
        "gender": "male",
        "product_expiration": 2013-12-20T00:00:00, 
        "offers":
        [{
            "description": "White/New Navy/Strong Blue",
            "price": 45.00,
            "currency_code": "USD",
            "standard_price": 55.00,
            "availability": "in stock",
            "sale_start_date": 2013-12-24T00:00:00,
            "sale_end_date": 2013-12-31T00:00:00,
        },{
            "description": "Black/White/Dark Shadow",
            "price": 52.00,
            "currency_code": "USD",
            "standard_price": 55.00,
            "availability": "in stock",
            "sale_start_date": 2013-12-24T00:00:00,
            "sale_end_date": 2013-12-31T00:00:00,
        }]
       }]
}
        

Semantic Markup

Open Graph tags

This method uses the Open Graph standard developed by Facebook. You include information about your products in the HTML header of the product page. For example: shop.famsf.org/do/product/BK5160 would include the following in the HTML header:

<head>
  <meta property="og:title" content="de Young Copper Bookmark" />
  <meta property="og:description" content="Our signature bookmark derived from the de Young's unique architecture and copper exterior. Measures 5 3/4'' x 1 1/4''. FAMSF Exclusive." />
  <meta property="og:type" content="product" />
  <meta property="og:url" content="http://shop.famsf.org/do/product/BK5160" />
  <meta property="og:image" content="http://shop.famsf.org/storeImages/images/store/BK5160.jpg" />
  <meta property="og:image" content="http://shop.famsf.org/storeImages/images/store/BK5161.jpg" />
  <meta property="og:site_name" content="FAMSF Store" />
  <meta property="og:price:amount" content="15.00" />
  <meta property="og:price:standard_amount" content="20.00" />
  <meta property="og:price:currency" content="USD" />
  <meta property="og:availability" content="instock" />
  <meta property="og:see_also" content="http://shop.famsf.org/do/product/MG-230-001" />
  <meta property="og:rating" content="4.5" />
  <meta property="og:rating_scale" content="5" />
  <meta property="og:rating_count" content="120" />
  <meta property="product:gender" content="unisex" >
  <meta property="product:color" content="Aqua" >
  <meta property="product:color:map" content="blue" >
  <meta property="product:color:image" content="http://cdn-i3.farfetch.com/C.jpg" >
  <meta property="product:color:image" content="http://cdn-i3.farfetch.com/D.jpg" >
      ...
</head>
            

If you already use Open Graph tags in your product pages, adding product info should be straightforward. On the downside, this format doesn't support multiple products descriptions in one page. Learn more at http://ogp.me/ns/product and http://ogp.me/.

Supported fields:

Field Description Required?
og:type Must be "product" or "og:product" Y
og:title Product name, may be truncated, all formatting and HTML tags will be removed. Y
product:price:amount Product price (without currency sign, for example "6.50"). Y
product:price:currency Currency code string as defined in http://www.xe.com/iso4217.php (for example "USD"). Y
og:site_name Store name (for example "Etsy"); specifying this field is strongly suggested. N
og:image URL for a high resolution image for the product. Up to 6 og:image tags can be provided. N
og:url Canonical URL for the page, for example "http://www.etsy.com/listing/83934917/chocolate-raspberry-drizzle-body-lotion" (you can also specify canonical with standard HTML markup: <link rel="canonical" href="..."/>) N
og:description Product description, may be truncated, all line breaks and HTML tags will be removed. N
og:price:standard_amount If product is on sale, the non-sale price. N
og:price:start_date Start time of the sale in ISO 8601 date format. N
og:price:end_date End time of the sale in ISO 8601 date format. N
og:see_also Related products from the same domain. Up to 6 og:see_also tags can be provided. N
og:referenced Referenced items in this product. Up to 6 og:referenced tags can be provided. N
og:brand Brand name (for example "Lucky Brand") N
og:upc or
og:ean or
og:isbn
ID that uniquely identifies the product within your site. N
og:availability Case insensitive string, possible values: "in stock" (or "instock"), "preorder", "backorder" (or "pending"; will be back in stock soon), "out of stock" (or "oos"; may be back in stock some time), "discontinued". Discontinued items won't be part of a daily scrape and marking them as such will decrease the load on your servers. N
og:availability:destinations ISO 3166-1 alpha-2 country code representing a country the product can be shipped to. If available anywhere in the world, use "All". Multiple countries can be provided. N
product:expiration_time A time representing when the product expired (or will expire) in ISO 8601 date format. N
product:gender Gender property of this product can only be 'male', 'female' and 'unisex'. N
product:color A color the product is available in (e.g. hazel). All available colors may be specified. N
product:color:map Standardized version of the color. Must be provided for each product:color. One of 'beige', 'black', 'blue', 'bronze', 'brown', 'gold', 'green', 'gray', 'metallic', 'multicolored', 'off-white', 'orange', 'pink', 'purple', 'red', 'silver', 'transparent', 'turquoise', 'white', or 'yellow'. N
product:color:image URL of high resolution image for the product with this specific color. N
og:rating Aggregate rating for the item (e.g. 4.5). N
og:rating_scale Number (int), maximum value of the ratings scale. Required if og:rating provided (e.g. 5). N
og:rating_count Number (int), rating count of which the product is rated (e.g. 113). N

Schema.org tags

Schema.org tags are supported by Google and other search engines. In this method you markup the HTML body of the product page. Here is an example for this product: shop.famsf.org/do/product/BK5160.

<meta property="og:site_name" content="FAMSF Store" />
<div itemscope itemtype="http://schema.org/Product">
  <meta itemprop="name" content="de Young Copper Bookmark" />
  <meta itemprop="url" content="http://shop.famsf.org/do/product/BK5160" />
  <meta itemprop="image" content="http://shop.famsf.org/images/111111.jpg" />
  <meta itemprop="image" content="http://shop.famsf.org/images/222222.jpg" />
  <span itemprop="description">Our signature bookmark derived from the de Young's
   unique architecture and copper exterior. Measures 5 3/4'' x 1 1/4''. FAMSF
   Exclusive.</span>
  <div itemprop="color" itemscope itemtype="http://schema.org/ProductColor">
    <span itemprop="name">Aqua</span>
    <meta itemprop="map" content="blue" />
    <meta itemprop="image" content="http://cdn-i3.farfetch.com/B.jpg" />
  </div>
  <div itemprop="color" itemscope itemtype="http://schema.org/ProductColor">
    <span itemprop="name">Rose</span>
    <meta itemprop="map" content="red" />
    <meta itemprop="image" content="http://cdn-i3.farfetch.com/B.jpg" />
  </div>
  <a itemprop="relatedItem" href="http://shop.famsf.org/do/product/444444"></a>
  <a itemprop="relatedItem" href="http://shop.famsf.org/do/product/222222"></a>
  <a itemprop="relatedItem" href="http://shop.famsf.org/do/product/333333"></a>
  <div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
    <span itemprop="price">$15.00</span>
    <meta itemprop="priceCurrency" content="USD" />
    <meta itemprop="availability" itemtype="http://schema.org/ItemAvailability"
     content="http://schema.org/InStock" />
  </div>
</div>
            

Schema.org is slightly more complex than Open Graph as you have to modify the HTML body, not just the header. On the plus side, Schema.org supports multiple products and offers on the page. for more information: http://schema.org/Product and http://schema.org/docs/gs.html.

We suggest that you also include your site name using an Open Graph og:site_name tag. Schema.org doesn't support a site name field.

Schema.org/Product fields:

Field Description Required?
url Canonical URL for the page, for example "http://www.etsy.com/listing/83934917/chocolate-raspberry-drizzle-body-lotion" Y
name Product name, may be truncated, all formatting and HTML tags will be removed. Y
description String, product description,may be truncated, all formatting and HTML tags will be removed. N
brand Brand name (for example "Lucky Brand") N
productId ID that uniquely identifies the product within your site. N
image URL of high resolution image for this product. Up to 6 images can be provided. N
relatedItem URL (must be the same domain) representing the related products. N
referencedItem List of URLs representing the referenced other productsi. N
productExpiration the product expiration date in ISO 8601 date format. N
gender Gender property of this product can only be 'male', 'female' and 'unisex'. N
color The color spec definition using schema.org/ProductColor, which contains name, map and image properties. N
aggregateRating Overall rating for this place using schema.org/AggregateRating. bestRating and ratingValue are required for rating to be specified. N

Schema.org/Offer fields:

Field Description Required?
name Optional offer name, may be truncated, all formatting and HTML tags will be removed. N
description Optional product description, may be truncated, all formatting and HTML tags will be removed. N
sku ID that uniquely identifies the offer within your site. N
price Offer price (currency sign will be removed, for example "6.50"). Y
priceCurrency Currency code as defined in http://www.xe.com/iso4217.php (for example "USD"). Y
standardPrice Number (float) Product's original price if it is on sale (without currency sign, for example "10.00"). N
availability Following values are accepted as in stock: "http://schema.org/InStock” (or "InStock"), "http://schema.org/OnlineOnly" (or "OnlineOnly") , "http://schema.org/InStoreOnly” (or "InStoreOnly"). Other possible values are: "http://schema.org/OutOfStock” (or "OutOfStock"), "http://schema.org/PreOrder” (or "PreOrder") "http://schema.org/Discontinued” (or "Discontinued") Discontinued items won’t be part of a daily scrape and marking them will decrease load on your servers. N
availabilityStarts If the product is on sale, the start date in ISO 8601 date format. N
availabilityEnds If the product is on sale, the end date in ISO 8601 date format. N
eligibleRegion The list of product available geographic areas in ISO 3166 Country Code format. Can be 'All' if applies for all countries. N

Examples

Here are some examples of product Pins:

Recipe Rich Pins

For recipes we support Schema.org and hRecipe formats.
Here is a sample recipe we will use in our examples:

    Orange-Pineapple-Carrot Smoothie
    This fresh and healthy smoothie is a great snack after a workout.
    Serves 1
    Preparation Time: 10 minutes
    Total Time: 10 minutes
    Ingredients:
       3/4 cup chopped fresh pineapple
       1/3 cup ice
       1 cup orange juice
       1 chopped carrot
       1/2 banana
    Directions:
    Put the pineapple, ice, orange juice, carrot and banana in a
    blender. Blend until smooth.
    Ratings 8.2/10 from 200 users.
    You might also be interested in our Orange Daiquiri recipe.
    

Schema.org tags

Here is the sample recipe marked up with Schema.org tags:

<meta property="og:site_name" content="MyRecipeSite.com" />
<div itemscope itemtype="http://schema.org/Recipe">
  <span itemprop="name">Orange-Pineapple-Carrot Smoothie</span>
  <span itemprop="description">This fresh and healthy smoothie is a great snack after a workout.</span>
  <meta itemprop="url" content="http://myrecipesite.com/pinapple_smoothie.html" />
  <img itemprop="image" src="http://myrecipesite.com/static/pinapple.png" alt="Pinapple Smoothie" />
  Preparation Time: <meta itemprop="prepTime" content="PT10M">10 minutes
  Total time: <meta itemprop="totalTime" content="PT10M">10 minutes
  <span itemprop="recipeYield">Serves 1</span>
Ingredients:
  <span itemprop="ingredients">3/4 cup chopped fresh pineapple</span>,
  <span itemprop="ingredients">1/3 cup ice</span>,
  <span itemprop="ingredients">1 cup orange juice</span>,
  <span itemprop="ingredients">1 chopped carrot</span>,
  <span itemprop="ingredients">1/2 banana</span>.
Instructions:
  <span itemprop="recipeInstructions">
  Put the pineapple, ice, orange juice, carrot and banana in a blender. Blend until smooth.
  </span>
<div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
  <span itemprop="ratingValue">8.2</span>/<span itemprop="bestRating">10</span> from
  <span itemprop="ratingCount">200</span> users.
</div>
You might also be interested in our
 <a itemprop="relatedItem" href="http://myrecipesite.com/orange_daiquiri.html">
    Orange Daiquiri
  </a> recipe.
</div>
    

More information: http://schema.org/Recipe reference and Getting started with Schema.org. We suggest that you also include your site name using an og:site_name tag.

Supported fields:

Field Description Required?
name Title of the recipe. All formatting and HTML tags will be removed. Long titles may be truncated on Pinterest for display purposes. Y
ingredients Ingredients used the recipe. Annotate each individual ingredient separately. Y
url Canonical URL for the page, e.g. "http://allrecipes.com/recipe/simple-white-cake/" (The canonical URL may also be specified with standard HTML head tags: <link rel="canonical" href="..."/>) N
image URL for a high resolution image for the recipe. Up to 6 images can be provided. N
cookTime Time it takes to cook the recipe, in ISO 8601 duration format. N
prepTime Time it takes to prepare the recipe, in ISO 8601 duration format. N
totalTime Total time it takes to cook and prepare the recipe, in ISO 8601 duration format. N
recipeYield Quantity yielded or servings made by this recipe, e.g. "5 servings" or "Serves 4-6" or "Yields 10 burgers". N
description Recipe description. This field is not displayed on Pinterest, but may be indexed for search purposes. N
aggregateRating Recipe ratings as defined in http://schema.org/AggregateRating. N
relatedItem URL (must be the same domain) representing the related recipes. N

hRecipe Tags

Here is the sample recipe marked up with the hRecipe tags:

<meta property="og:site_name" content="MyRecipeSite.com" />
<div class="hrecipe">
    <h1 class="fn">Orange-Pineapple-Carrot Smoothie</h1>
    <p class="summary">This fresh and healthy smoothie is a great snack
    after a workout.</p>
    <img class="photo" src="http://myrecipesite.com/static/pinapple.png" alt="Pinapple Smoothie" />
    Ingredients:
    <ul>
        <li class="ingredient">3/4 cup chopped fresh pineapple</li>
        <li class="ingredient">1/3 cup ice</li>
        <li class="ingredient">1 cup orange juice</li>
        <li class="ingredient">1 chopped carrot</li>
        <li class="ingredient">1/2 banana</li>
    </ul>
    Instructions:
    <ul class="instructions">Put the pineapple, ice, orange juice, carrot and banana in a blender. Blend until smooth.</ul>
    <span class="yield">Serves 1</span>
    <p>Preparation time:
        <span class="preptime"><span class="value-title" title="10M">
        </span>10min</span>
    </p>
    <p>Total time:
        <span class="duration"><span class="value-title" title="10M">
        </span>10min</span>
    </p>
    <div class="hreview-aggregate" ><span class="rating" >
        <span class="average">8.2</span>/<span class="best">10</span> from
        <span class="count">200</span> users.
    </span></div>
</div>

More information: http://microformats.org/wiki/hrecipe. We suggest that you also include your site name using an og:site_name tag.

Supported fields:

Field Description Required?
fn Title of the recipe. All formatting and HTML tags will be removed. Long titles may be truncated on Pinterest for display purposes. Y
ingredient Ingredients used the recipe. Annotate each individual ingredient separately. Y
url Canonical URL for the page, e.g. "http://allrecipes.com/recipe/simple-white-cake/" (The canonical URL may also be specified with standard HTML head tags: <link rel="canonical" href="..."/>) N
photo URL for a high resolution image for the recipe. Up to 6 images can be provided. N
cookTime Time it takes to cook the recipe, in ISO 8601 duration format. N
prepTime Time it takes to prepare the recipe, in ISO 8601 duration format. N
duration Total time it takes to cook and prepare the recipe, in ISO 8601 duration format. N
yield Quantity yielded or servings made by this recipe, e.g. "5 servings" or "Serves 4-6" or "Yields 10 burgers". N
summary Recipe description. This field is not displayed on Pinterest, but may be indexed for search purposes. N
rating The aggregate rating of the recipe as defined in http://microformats.org/wiki/hreview-aggregate N

Examples

Here are some examples of recipe Pins:

Movie Rich Pins

For movies we support the Schema.org movie format.
Here is a sample movie description we will use in our examples:

Taxi Driver (1976)
Travis Bickle (Robert De Niro) becomes a nighttime taxi driver in order to cope with chronic insomnia.
Director: Martin Scorsese
Stars: Robert De Niro, Jodie Foster, Albert Brooks
Ratings 10/10 from 200 users. Reviews: 50.
Similar movies include The Girl with the Dragon Tattoo and Marathon Man.

Schema.org tags

Here is the sample movie marked up with Schema.org tags:

<meta property="og:site_name" content="MyMovieSite.com" />
<div itemscope itemtype="http://schema.org/Movie">
    <meta itemprop="url" content="http://mymoviesite.com/taxidriver_1976.html" />
    <h1 itemprop="name">Taxi Driver (1976)</h1>
    <img itemprop="image" src="http://mymoviesite.com/taxidriver_image.png" alt="Man and Taxi"  />
    <span itemprop="description">Travis Bickle (Robert De Niro) becomes a nighttime taxi driver in order to cope with chronic insomnia.</span>
Director:
    <div itemprop="director" itemscope itemtype="http://schema.org/Person">
        <span itemprop="name">Martin Scorsese</span>
    </div>
    Stars:
    <div itemprop="actor" itemscope itemtype="http://schema.org/Person">
        <span itemprop="name">Robert De Niro</span>,
    </div>
    <div itemprop="actor" itemscope itemtype="http://schema.org/Person">
        <span itemprop="name">Jodie Foster</span>,
    </div>
    <div itemprop="actor" itemscope itemtype="http://schema.org/Person">
        <span itemprop="name">Albert Brooks</span>
    </div>
    <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
        <span itemprop="ratingValue">10</span>/<span itemprop="bestRating">10</span> from
        <span itemprop="ratingCount">200</span> users.
        Reviews: <span itemprop="reviewCount">50</span>.
    </div>
    Similar movies include 
    <a itemprop="relatedItem" itemscope itemtype="http://mymoviesite.com/thegirlwiththedragontattoo_2011.html">
        The Girl with the Dragon Tattoo
    </a> and 
    <a itemprop="relatedItem" href="http://mymoviesite.com/marathonman_1976.html">
        Marathon Man
    </a>
</div>
    

More information: http://schema.org/Movie reference and Getting started with Schema.org. We suggest that you also include your site name using an og:site_name tag.

Supported fields:

Field Description Required?
url Canonical URL for the page, for example "http://mymoviesite.com/taxidriver_1976.html" (you can also specify canonical with standard HTML markup: <link rel="canonical" href="..."/>) Y
name Movie title, may be truncated, all formatting and HTML tags will be removed. Y
description Movie description, may be truncated, all formatting and HTML tags will be removed. N
image URL for a high resolution image for the movie. Up to 6 images can be provided. N
duration Duration of the movie, in ISO 8601 duration format. N
genre Genre of the movie. N
actor Cast member of the movie as defined in http://schema.org/AggregateRating (annotate each person separately). N
director Director of the movie as defined in http://schema.org/AggregateRating (annotate each person separately). N
contentRating Content rating (For example "PG-13"). N
datePublished Movie release date in in ISO 8601 date format. N
aggregateRating Movie ratings as defined in http://schema.org/AggregateRating. N
relatedItem URL (must be the same domain) representing the related movie. N

Examples

Here are some examples of movie Pins:

Article Rich Pins

We support Open Graph and Schema.org article formats.

Open Graph tags

This method uses the Open Graph article type. You include information about your article in the HTML header of the article page. Here's an example:

<head>
    <meta property="og:title" content="Top 10 national parks in California" />
    <meta property="og:description" content="Yosemite, Death Valley, Joshua Tree, Redwood ... California's national and state parks are home to some of the most iconic views and landscapes on the planet" />
    <meta property="og:type" content="article" />
    <meta property="og:url" content="http://www.theguardian.com/travel/2013/sep/17/top-10-national-parks-california" />
    <meta property="og:site_name" content="the Guardian" />
    <meta property="og:image" content="http://static.guim.co.uk/sys-images/Travel/Pix/gallery/2013/9/16/1379354751315/Death-Valley-Calif.-001.jpg" />
    <meta property="og:image" content="http://static.guim.co.uk/sys-images/Travel/Pix/pictures/2013/9/16/1379341709817/Yosemite-Great-Falls-US-001.jpg" />
    <meta property="og:see_also" content="http://www.theguardian.com/world/gallery/2013/aug/24/wildfire-threatens-yosemite-national-park" />
    <meta property="og:see_also" content="http://www.theguardian.com/travel/2013/jul/20/top-10-outdoor-trips-activities-utah-usa" />
    <meta property="og:referenced" content="https://foursquare.com/v/death-valley-national-park/4d1a73a91683a143ce977451" />
    <meta property="og:referenced" content="https://foursquare.com/v/yosemite-national-park/4ba3d06ef964a520706238e3" />
    <meta property="article:published_time" content="2013-09-17T05:59:00+01:00" />
    <meta property="article:modified_time" content="2013-09-16T19:08:47+01:00" />
    <meta property="article:section" content="Travel" />
    <meta property="article:tag" content="California" />
    <meta property="article:tag" content="Travel" />
    <meta property="article:tag" content="United States" />

    <meta property="og:rating" content="4.9">
    <meta property="og:rating_scale" content="10">
    <meta property="og:rating_count" content="1511">

    ...
</head>
        

Supported fields:

Field Description Required?
og:type Must be "article" or "blog" Y
og:title Article title, may be truncated, all formatting and HTML tags will be removed. Y
og:site_name Site name (for example "the Guardian"); specifying this field is strongly suggested. N
og:url Canonical URL for the page, for example "http://www.theguardian.com/travel/2013/sep/17/top-10-national-parks-california" (you can also specify canonical with standard HTML markup: <link rel="canonical" href="..."/>) N
og:description Article description or summary, may be truncated, all line breaks and HTML tags will be removed. Y
og:image URL for a high resolution image for the article. Up to 6 og:image tags can be provided. N
og:see_also URL pointing to other related articles from the same domain. Up to 6 og:see_also tags can be provided. N
og:referenced Canonical URL for an item referenced in the article. The page referenced need not be on the same domain as the original article. For example, you might reference a page where a product can be purchased or a page that further describes a place. N
article:published_time Article publish time in ISO 8601 date format. N
article:modified_time Article modification time in ISO 8601 date format. N
article:author Article author, all line breaks and HTML tags will be removed. N
article:section Article section name, all line breaks and HTML tags will be removed. N
article:tag Article tag or keyword, all line breaks and HTML tags will be removed. N
og:rating Aggregated rating for the place (e.g. 4.5). N
og:rating_scale Number (int), maximum value of the ratings scale. Required if og:rating provided (e.g. 5). N
og:rating_count Number (int), rating count of which the article is rated (e.g. 113). N

Schema.org tags

Schema.org tags are supported by Google and other search engines. In this method, you mark up the HTML body of the article page using schema.org/Article properties. Here's an example:

<meta property="og:site_name" content="Example Site" />
<div itemscope itemtype="http://schema.org/Article">
    <meta itemprop="url" content="http://www.example.com/2013/10/article.html" />
    <span itemprop="name" content="Article Title" />
    by <span itemprop="author" content="Johh Doe" />
    <img itemprop="image" src="http://www.example.com/2013/article_image.png" alt="Moon and Saturn"  />
    <span itemprop="description">A description or summary of the article.</span>
    <div itemprop="relatedItem" itemscope itemtype="http://schema.org/Article">
        <a itemprop="url" href="http://www.example.com/2013/09/older_article.html">
    </div>
    <div itemprop="realatedItem" itemscope itemtype="http://schema.org/Article">
        <a itemprop="url" href="http://www.example.com/2013/08/different_article.html">
    </div>
</div>
        

We suggest you also include your site name using an Open Graph og:site_name tag. Schema.org doesn't support a site name field.

Schema.org/Article fields:

Field Description Required?
url Canonical URL for the page, for example "http://www.example.com/2013/10/article.html". Y
name Article name, may be truncated, all formatting and HTML tags will be removed. Y
description String, article description or summary, may be truncated, all formatting and HTML tags will be removed. Y
image URL for a high resolution image for the article. Up to 6 images can be provided. N
datePublished Date of first publication in ISO 8601 date format. N
author String, article author, all formatting and HTML tags will be removed. N
articleSection Article section name, all line breaks and HTML tags will be removed. N
keywords Article tags or keywords, all line breaks and HTML tags will be removed. N
wordCount An integer representing the number of words in the text of the article. N
aggregateRating Movie ratings as defined in http://schema.org/AggregateRating. N
relatedItem URL (must be the same domain) representing the related movie. N
referencedItem Canonical URL for an item referenced in the article. The page referenced need not be on the same domain as the original article. For example, you might reference a page where a product can be purchased or a page that further describes a place. N

Place Rich Pins

We support Open Graph and Schema.org formats.

Open Graph Tags

This method uses the Open Graph standard developed by Facebook. You include information about your place in the HTML header of the place page. Here's an example:

<head>
    <meta property="og:title" content="Civic Center/UN Plaza BART Station" />
    <meta property="og:description" content="Subway in San Francisco, CA"/>
    <meta property="og:url" content="https://foursquare.com/v/civic-centerun-plaza-bart-station/4813bc50f964a520414f1fe3" />
    <meta property="og:type" content="place" />
    <meta property="playfoursquare:location:latitude" content="37.7792418232402" />
    <meta property="playfoursquare:location:longitude" content="-122.41431589072604" />
    <meta property="og:site_name" content="Foursquare" />
    ...
</head>
        

Supported fields:

Field Description Required?
og:type Must be "place" or "og:place" Y
og:title Place Name Y
og:description Place Description N
*:location:latitude Latitude. "*" can be anything except blank (e.g. place:location:latitude). Y
*:location:longitude Longitude. "*" can be anything except blank (e.g. place:location:longitude). Y
og:image Link to high resolution image. Up to 6 og:image tags can be provided. N
og:see_also URL pointing to other related places from the same domain. Up to 6 og:see_also tags can be provided. N
og:rating Aggregated rating for the place (e.g. 4.5). N
og:rating_scale Number (int), maximum value of the ratings scale. Required if og:rating provided (e.g. 5). N
og:rating_count Number (int), rating count of which the place is rated(e.g. 113). N
*:street_address Street address. "*" can be anything except blank (e.g. place:street_address). N
*:locality Locality (i.e. city). "*" can be anything except blank (e.g. place:locality). N
*:region Region (i.e. state). "*" can be anything except blank (e.g. place:region). N
*:postal_code Postal code. "*" can be anything except blank (e.g. place:postal_code). N

Schema.org tags

Schema.org tags are supported by Google and other search engines. In this method, you mark up the HTML body of the place page using schema.org/Place properties. Here's an example:

<div itemscope itemtype="http://schema.org/Place">
    <meta itemprop="url" content="http://www.example.com/places/yerba_buena.html" />
    <span itemprop="name" >Yerba Buena Gardens.</span>
    <span itemprop="description" content="Yerba Buena Gardens Public Park." />
    <meta itemprop="image" content="http://www.example.com/image/1.jpg" />
    <meta itemprop="image" content="http://www.example.com/image/2.jpg" />
    <meta itemprop="image" content="http://www.example.com/image/3.jpg" />
    Located at:
    <div itemprop="geo" itemscope itemtype="http://schema.org/GeoCoordinates">
        <span itemprop="latitude">37.7840</span>, 
        <span itemprop="longitude">-122.4020</span>
    </div>
    <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
        <span itemprop="streetAddress">750 Howard St</span>,
        <span itemprop="addressLocality">San Francisco</span>,
        <span itemprop="addressRegion">CA</span>
        <span itemprop="postalCode">94103</span>
    </div>
    <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
        <span itemprop="bestRating" content="5" />
        <span itemprop="ratingValue" content="4.3" />
    </div>
</div>
        

We suggest you also include your site name using an Open Graph og:site_name tag. Schema.org doesn't support a site name field.

Schema.org/Place fields:

Field Description Required?
name Place name Y
geo Geographic location of the place (latitude and longitude) using schema.org/GeoCoordinates. Y
description Description of the place N
url URL for the place N
image URL of high resolution image for this place. Up to 6 images can be provided. N
address Physical address of the place using schema.org/PostalAddress. streetAddress, addressLocality, and addressRegion are required for address to be specified. N
telephone Telephone number of the place N
aggregateRating Overall rating for this place using schema.org/AggregateRating. bestRating and ratingValue are required for rating to be specified. N
relatedItem URL (must be the same domain) representing the related places. N

Schema.org/LocalBusiness (inherits from Schema.org/Place):

Field Description Required?
openingHours Hours of operation (e.g. "Mo-Fr, 10:00-18:00") N

Opting out of Rich Pins

If you don't want your pages to render as Rich Pins, you can insert the following <meta> tag into the HTML head section of your pages. It's important to point out that this tag only applies to Rich Pins and is not the same as the "nopin" tag, which prevents people from adding things to Pinterest from your site.

<meta name="pinterest-rich-pin" content="false" />