Pinterest Product Feed Specification for Shopify

Sales channel

Feeds are consumed by Pinterest catalogues.

Pinterest turns an uploaded product feed into Product Pins, which are shoppable pins that carry live price and availability from the catalogue. Its feed specification borrows Google's attribute names, and its distinguishing requirement is that every item needs a genuinely usable image, because the image is the entire unit of discovery on Pinterest.

Feed specification

Destination: Pinterest catalogues
Accepted formats: CSV TSV XML (RSS 2.0) XML (Atom 1.0)
Refresh: Pinterest fetches a scheduled feed once every 24 hours, at a time you choose. There is no sub-daily scheduled fetch, so price and stock accuracy depends on the feed being regenerated before Pinterest pulls it.

Attributes for Pinterest

Every attribute documented in this knowledge base that Pinterest accepts.

Attribute	Requirement	Notes
availability	Required	Only refreshed once every 24 hours.
brand	Optional	Brand name
condition	Optional	Product condition
description	Required	Product description
gtin	Optional	Global Trade Item Number
id	Required	Product ID
image_link	Required	The image is the listing. Vertical crops perform materially better.
item_group_id	Optional	Item group ID
link	Required	Product landing page URL
mpn	Optional	Manufacturer Part Number
price	Required	Product price
sale_price	Optional	Sale price
title	Required	Product title

What catches Shopify merchants out

The image is the product

On Google a poor image costs you a little click-through. On Pinterest the image is the listing, and vertical or near-square crops materially outperform the landscape images many Shopify themes produce. It is worth mapping a dedicated image where one exists.

One feed per locale, not one feed with locales

Pinterest expects a separate feed per country and language combination rather than a single feed carrying every market. A Shopify store selling into several markets needs one generated feed per market.

Product Pins go stale quietly

Because the fetch is daily and there is no push API for routine updates, a sold-out product can stay pinned as available for most of a day. Regenerating the feed shortly before the scheduled fetch narrows that window as far as the channel allows.

Common Pinterest errors

Image link cannot be crawled An image crawl failure means the channel could not retrieve the file at image_link, or retrieved it and judged it unusable. On Shopify the URL itself is rarely wrong, so the cause is usually a rate limit hit during a first full crawl, a temporary CDN response, or an image whose content breaks policy rather than one that is genuinely missing.

Frequently asked questions

How often does Pinterest update a product feed?

Pinterest fetches a scheduled feed once every 24 hours at a time you choose. There is no more frequent scheduled option, so the practical way to keep Product Pins accurate is to regenerate your feed shortly before Pinterest's fetch window.

Do I need a separate Pinterest feed for each country?

Yes. Pinterest expects one feed per country and language combination rather than a single multi-market feed, so a Shopify store selling into several markets needs a generated feed per market.

Primary sources

Channel specifications change. These are the official documents this page is based on.

Last reviewed 16 September 2026 View as markdown