Enable Rich Pins for your site

Rich Pins add extra details to Pins from your website. Right now, there are four types of Rich Pins: product, article, app install and recipe.


Add Rich Pins to your site:

  1. Prep your website with meta tags or an oEmbed endpoint. This can be a bit technical, so you might need to loop in your website’s developer. You can get quick instructions for each type of Rich Pin below.
  2. Test out your Rich Pins.
  3. Apply to get them on Pinterest.

For the full developer documentation on Rich Pins, check out our developer site.


Get instructions for each Pin type:

When you apply for Rich Pins, you should mark up your website according to the most applicable Pin type. So if you have recipes on your site, add the markup for recipe Pins not article Pins.
 

Product Pins Product Pins
Product Pins let you show the price, stock status and product description on Pins from your website.
 
To add product Pins to your site:

1. Add Open Graph or  Schema.org markups between the <head> </head> section of your HTML code for each page you want to enable product Rich Pins on. If you are using Shopify, check out the instructions below specifically for Shopify sites. Here are the required Rich Pin fields for each type of markup. Edit the highlighted fields to reflect your products.

Open Graph markups:
<meta property="og:title" content="de Young Copper Bookmark" />
<meta property="og:type" content="product" />
<meta property="og:price:amount" content="15.00" />
<meta property="og:price:currency" content="USD" />
 

Schema.org markups:

<div itemscope itemtype="https://schema.org/Product">

<meta itemprop="name" content="de Young Copper Bookmark" />
<meta itemprop="url" content="https://shop.famsf.org/do/product/BK5160" />
<div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
<span itemprop="price">.00</span>
<meta itemprop="priceCurrency" content="USD” />
<meta itemprop="availability" itemtype="https://schema.org/ItemAvailability"
</div>
 

2. Use our Rich Pin validator to make sure we can see the Rich Pin data.

3. If everything looks good, click Apply now. Make sure to pick the right markup type when applying. 

We're only adding product Rich Pins from sites where you can purchase those products. This means that you must be able to directly buy the product from your website, not from another site.
 
You don't need to add any markup if your website is hosted by:
  1. Shopify: Instead, go to our Rich Pin validator page, paste in your product link and add ".oembed" to the end of your link—you'll see all the Rich Pin information for your product. Apply for Rich Pins from this page (make sure to pick Shopify when applying).
  2. Etsy, Teachers Pay Teachers, eBay: New Pins from these sites will have product information on them within 24 hours. 

Check out our developer site to learn more. 

Article Pins Article Pins
Article Pins let you show the headline or title, the description and the author of your article or blog post.
 
To add article Pins to your site:

1. Add Open Graph or  Schema.org markups between the <head> </head> section of your HTML code for each page you want to enable article Rich Pins on. Here are the required Rich Pin fields for each type of markup. Edit the highlighted fields to reflect your articles.

Open Graph markups: 
<meta property="og:title" content="Title of your Article"/>
<meta property="og:description" content="Description of what your article" />
<meta property="og:type" content="article" />
 
Schema.org markups:
<meta property="og:site_name" content="Example Site” />
<div itemscope itemtype="https://schema.org/Article">
    <meta itemprop="url" content="https://www.example.com/2013/10/article.html" />
    <span itemprop="name" content="Article Title” /> by <span itemprop="author" content="Johh Doe” />
    <span itemprop="description">A description or summary of the article.</span>
    </div>
  1. Use our Rich Pin validator to make sure we can see the Rich Pin data.
  2. If everything looks good, click Apply now. Make sure to pick HTML tags when applying.
An article is a page that contains text, like a news article or blog post. We don't consider listicles or pages with mostly images and little text to be articles. 
 
 

App Install Pins App Install Pins
App Pins feature an Install button that takes iOS users to the App Store to download your app.
 
To create an App Pin:
  1. From the board view, select Add a Pin, then upload a Pin image from your computer or device
  2. Upload a high-resolution image of your app
  3. Edit the Pin to change the website to your App Store page
Check out the App Store on Pinterest for great examples of App Pins. Right now, only U.S. apps will be eligible for App Pins. Right now, App Pins are only available for U.S. apps and can only be seen on iOS devices.

Recipe Pins Recipe Pins
Recipe Pins let you add a title, serving size, cook time, ratings, and a list of ingredients to recipes from your site. We can also tell if something is paleo, vegetarian, vegan or gluten free.
 
To add recipe Pins to your site:

1. Add Schema.org or hrecipe markups between the <head> </head> section of your HTML code for each page you want to enable recipe Rich Pins on. Here are the required Rich Pin fields for each type of markup. Edit the highlighted fields to reflect your recipes. Note, Ratings are only supported using Schema.org markup at this time.

Schema.org markups:
<div itemscope itemtype="https://schema.org/Recipe">
    <span itemprop="name">
    Orange-Pineapple-Carrot Smoothie</span>
   <span itemprop="description">
    Description of your recipe.</span>
  <span itemprop="aggregateRating">
    Aggregate rating will show here</span>
    <meta itemprop="url"
    <span itemprop="recipeYield">Serves 1</span>
    Ingredients:
        <span itemprop="ingredients">ingredient 1</span>,
        <span itemprop="ingredients">ingredient 2</span>,
        <span itemprop="ingredients">ingredient 3</span>,
        <span itemprop="ingredients">
    add as many ingredient tags as you need</span>.
    Instructions:
    <span itemprop="recipeInstructions">
    Put the pineapple, ice, orange juice, carrot and
    banana in a blender. Blend until smooth.</span>
</div>
 
hrecipe tags:
<article class="h-recipe">
  <h1 class="p-name">Bagels</h1>
  <ul>
    <li class="p-ingredient">Flour</li>
    <li class="p-ingredient">Sugar</li>
    <li class="p-ingredient">Yeast</li>
  </ul>
  <p>Takes <time class="dt-duration" datetime="1H">1 hour</time>,
     serves <data class="p-yield" value="4">four people</data>.</p>
  <div class="e-instructions">
    <ol>
      <li>Start by mixing all the ingredients together.</li>
    </ol>
  </div>
</article>
 

2. Use our Rich Pin validator to make sure we can see the Rich Pin data.

3. If everything looks good, click Apply now. Make sure to pick HTML tags when applying.

Check out our developer site to learn more. 


Add Rich Pins to your Shopify Store

  1. Go to a specific product URL on your Shopify site  (this is a page that has a “Buy” or “add to bag” button)
  2. Copy and paste this product URL into the Rich Pin validator and type .oembed to the end of your product URL
  3. Click Validate
  4. After the preview appears, click Apply. You only need to apply with a single product URL from your website
  5. You will see your product Pins become Rich in 24 hours

Common questions:

Can I turn off Rich Pins for my site?
Do I have to mark up all of my pages?
Do I need to apply for each individual page on my site?
When will my Pins shows up as Rich Pins?
I'm seeing an error message when applying for Rich Pins
Why aren't my recipes appearing as Rich Pins?

If you don't want the Pins from your site to include rich info, just add this tag to the HTML head section of your pages:

Yes, you will need to add Rich Pin metatags to any page that you want to appear Rich on Pinterest. Please remember Rich Pins are only intended for specific product detail, article, or recipe pages. Pages such as home and category pages should not be marked up. You only need to validate and apply with one correctly marked up page in order to enable Rich Pins for any page containing metatags on your website.


No, you only need to apply with one page from your site. Once we approve your application, we’ll enable Rich Pins for your entire site. 

After you've been approved for Rich Pins, new Pins from your website will appear as Rich Pins if they have the correct product, article or recipe tags.
 
For older Pins, it may take a few weeks for them to appear as Rich Pins. 

If you're seeing We weren't able to retrieve any data from your URL, then Pinterest may be timing out before we can create a Pin on your site. Unfortunately, this isn't something we can fix on our end, and usually happens when a site is slow. This error also appears if your site blocks Amazon Web Services (AWS) requests. You'll have to remove this block before applying for Rich Pins.

If you're seeing It looks like your URL is missing some required info, then you're missing one or more of the required Rich Pin tags. Visit our developer site to learn which tags to add. 

We've recently stopped supporting hrecipe microformat v1, and are now only supporting microformat v2 for Recipe Rich Pins. To learn more about the new microformat, please refer to this helpful link: http://microformats.org/wiki/h-recipe
 
We recommend migrating to microformat v2, or schema.org tags, in order to support Recipe Rich Pins for your site.  


Note: As of January 2017, we are no longer supporting place and movie Rich Pin types. All existing place or movie Pins will continue to show as normal on Pinterest.