Ready to upload your catalogue and get your products on Pinterest? Before you get started, you’ll need to
Once you’ve set up Catalogues,
Alternatively, if you’re a developer, you can
Catalogues is a feed ingestion tool designed for businesses that sell products on their websites. Use of Catalogues requires:
If you’d like assistance with the above steps, you can partner with an e-commerce site that will format your products to publish on Pinterest. We currently support the following integrations:
If Catalogues is not right for you, you can promote your content in other ways on Pinterest. Learn how to
All destination URLs in your data source must have a web domain that is registered as a claimed website for your business account on Pinterest. A business can claim multiple domains, but each domain can only be claimed by a single Pinterest business account. Learn how to
Before you can set up your feed, you need to create a data source. You can add up to 20 data sources to account for the promotion of your products across different markets, languages and currencies.
A data source (also known as a product catalogue, product feed or data feed) is a file with a list of your products and their corresponding attributes structured in a specific way. This file is processed daily to create Pins from your products dynamically.
To submit a data source to Pinterest, you provide a URL link where we can access your data source file from. We'll validate the file and create a product Pin for each item that passes our validation.
Hosting a data source starts an ongoing effort to provide updated information about the products you have available. Pinterest will ingest your data source daily, and alert you about any errors. It's important to review and fix errors as quickly as possible to make sure your product info is accurate and up to date.
Depending on the error type, an error may mean that your whole feed is not updated, some items on your feed are not updated, or you need to make some formatting changes. Learn more about
Note: If you’re promoting Pins as ads and you update imagery for your entire catalogue, delivery of your shopping ads or collections ads could be delayed by a day or two.
You must provide your own hosting on an FTP/SFTP server, or set up an HTTP/HTTPS direct download link. Pinterest does not provide hosting for users. Your data source location should be accessible by a user-agent, and not require any IP or SSH key whitelisting. If you're using a direct download link in the form of HTTP/HTTPS, your link must not have any additional navigation required for Pinterest to access the file.
Supported formats:
We accept compressed files (.zip, .giz, .gz, .bz2 and others), but we currently do not support encrypted, password-protected compressed files. Google Drive and Dropbox feeds are also not supported.
Make sure that you follow our
There are seven required fields. Make sure the spaces, underscores and letter case match exactly with how the fields are written below. If any of these fields are missing or not properly formatted, your entire feed will fail ingestion.
Required fields:
If you want to display variants in the product detail page, so people browsing your products can select relevant details such as colour or size, these fields are required:
Different variants of the same product should have the same item_group_id.
There are also optional fields you can add to help Pinterest better map your products to people. The more information you provide, the more relevant your Pins will be to the people who see them. We strongly recommend adding our optional fields as well to add more detail to your feed and improve relevancy.
Note: If you update the image_link or the item_id, new Pins will be created by default. If you update the price, description or link, new Pins will not be created.
Note: If you change the product image later, you must update the image’s URL in the image_link field. Otherwise, the image will not update.
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| id |
The user-created unique ID that represents the product. Only Unicode characters are accepted. |
Max 127 characters | DS0294-L |
| title | The name of the product. Must be the same name as the product from the landing page. Include the variant details, such as colour and size. | Max 500 characters | Women’s denim shirt, large |
| description | The description of the product. This field does not support HTML and must be in plain text for optimal experience. | Max 10,000 characters | Casual fit denim shirt made with the finest-quality Japanese denim. |
| link | The landing page for the product. The link must lead directly to the same product and showcase the same data. We do not recommend hardwalls. The URL must start with http:// or https:// | Max 511 characters | |
| image_link |
The link to the main product image. Images should be at least 75x75 pixels to avoid errors. Use the additional_image_link field to add more images of your product. The image link must be accessible by the Pinterest user-agent and must provide accurate images. Make sure there are no template or placeholder images at the link. The image link can have a maximum of up to 2,000 characters and must start with http:// or https://. Encode or remove commas from the image link as we’re unable to process image links containing commas. We recommend enclosing the whole string with quotes. If you change the image later, the new image must use a different link or the image will not update. |
||
| price |
The price of the product. The price must reflect the true cost of the product and should include the currency in ISO-4217 if it is not in US dollars. If the currency is not included, we default to US dollars. We accept currency denotation before or after the numeric price value, with or without a space. Currency should follow the standard ISO-4217 code. We do not accept 0 values for price. Do not use currency symbols. If a sale price is provided, this field will be considered the list price and sale price will be considered the current price. |
<numeric> <ISO 4217> |
24.99 USD 24.99USD 24,99 USD 24,99USD 24.99 24,99 GBP24.99 GBP 24.99 GBP24,99 GBP 24,99 |
| availability | The availability of the product. Must be one of the following values: ‘in stock’, ‘out of stock’, ‘preorder’. | in stock out of stock preorder |
in stock |
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| product_type | The categorisation of your product based on your custom product taxonomy. Up to five sub-categories may be sent, separated by ' >'“. The > must be wrapped by spaces. We do not recognise any other delimiters such as commas or pipes. |
L0 > L1 > L2 > L3 > L4 Max 1000 characters Max five sub-categories |
Clothing > Women’s > Shirts > Denim |
| additional_image_link |
The links to additional images for your product. Up to 10 additional images can be used to show a product from different angles or to show different stages. Images should be at least 75x75 pixels to avoid errors. The image link must be accessible to the Pinterest user-agent and must provide accurate images. Make sure there are no template or placeholder images at the link. Each image link can have a maximum of up to 2,000 characters and must start with http:// or https://. Encode or remove commas from the image link, as we’re unable to process image links containing commas. Other delimiters will not be recognized. Use commas to separate each additional image link. We recommend enclosing the whole string with quotes. We'll create a new pin for every additional image link. If you change the image later, the new image must use a different link or the image will not be updated. |
" |
|
| mobile_link | The mobile-optimised version of your landing page. Must begin with http:// or https:// | ||
| sale_price |
The discounted price of the product. The sale_price must be lower than the price. Include currency in the same setup as price. It should include currency in ISO-4217 if it is not in US dollars. If the currency is not included, we default to US dollars. We accept currency denotation before or after the numeric price value, with or without a space. We do not accept 0 values. Do not use currency symbols. If provided, the sale price will be considered the current price of the item. |
<numeric> <ISO 4217> |
14.99 USD 14.99USD 14,99 USD 14,99USD 14.99 14,99 GBP 14.99 GBP14.99 GBP 14,99 GBP14,99 |
| average_review_rating | The average amount of reviews for the product. | <numeric> between 1-5 | 5 |
| number_of_ratings | The number of ratings for the product. | <numeric> | 2 |
| number_of_reviews | The number of reviews available for the product. | <numeric> | 4 |
| description_html | The HTML description for the item. This lets you use HTML formatting, such as bullet points, which makes your description easier to read. We recommend using this if your description is longer than 200 characters. If this field is provided, we will use it instead of description. However, the description field is still required. |
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| item_group_id | The parent ID of the product. | Max 127 characters | DS0294 | required for items with multiple variants |
|
brand |
The brand of the product. | Josie’s Denim | optional | |
| gtin | The unique universal product identifier. It should follow |
Numeric | 3234567890126 | optional |
| mpn | Manufacturer Part Number are alphanumeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer. | Alphanumeric | "mpn": "PI12345NTEREST" |
optional |
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
|
colour |
The primary colour of the product. | blue | |
| gender | The gender associated with the product. Must be one of the following values: ‘male’, ‘female’, ‘unisex’. | male female unisex |
female |
| age_group | The age group to apply a demographic range to the product. Must be one of the following values: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’. | newborn infant toddler kids adult |
adult |
| material | The material used to make the product. | cotton | |
| pattern | The description of the pattern used for the product. | plaid | |
| size | The size of the product. | M | |
| size_type | Additional description for the size. Must be one of the following values: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’. | regular petite plus big_and_tall maternity |
regular |
| size_system | Indicates the country’s sizing system in which you are submitting your product. | Country code |
US |
| alt_text | Additional attribute to describe what appears in the main images of the product. | One or more alt text values, separated by commas. The number of alt text values should match the number of images in your image_link column. Commas must be encoded as ,, or removed if they are part of the alt text, as we cannot process image links containing alt text. Commas should be used to separate multiple alt texts. | A light blue crochet baby hat with tassels |
| variant_names | Options for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. | Texts separated by commas | Colour,Size |
| variant_values | Option values for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. The order of the variant values must be consistent with the order of the variant names. | Texts separated by commas | Red,Small |
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| tax | Tax consists of one group of up to four elements: country, region, rate (all required) and tax_ship (optional). All colons, even for blank values, are required. | country:region:rate(required):tax_ship | US:1025433:6.00:y |
| shipping | Shipping consists of one group of up to four elements: country, region, service (all optional) and price (required). All colons, even for blank values, are required. |
country:region:service:price(required) |
US:CA:Ground:0 USD US::Express:13.12 |
|
shipping_weight |
The weight of the product. Ensure there is a space between the numeric string and the metric. | <numeric> <metric> | 3 kg 5 lbs |
| shipping_width | The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. | <numeric> <metric> | 16 in |
| shipping_height | The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. | <numeric> <metric> | 12 in |
| free_shipping_label | Whether you offer free delivery for the item or not. If you do, enter 0 as the free_shipping_limit. If you only offer free delivery after someone spends a specific amount, enter that amount as the free_shipping_limit. | true false |
true |
| free_shipping_limit | The minimum order purchase necessary to obtain free delivery. This is only relevant if you offer free delivery. |
<numeric> <ISO 4217> |
35 USD |
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| adult | Set this attribute to TRUE if you're submitting items that are considered “adult”. These will not be shown on Pinterest. | TRUE FALSE |
true |
This feature is currently available to certain US merchants who have early access to Checkout. Learn more about
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| checkout_enabled | Set this attribute to FALSE to indicate items that should be excluded from the Pinterest Checkout programme. Note that this product is currently being tested and your account must be enrolled. Please get in touch with your Account Manager or |
TRUE FALSE |
false |
Custom grouping of products can be used for a variety of purposes such as seasonal, promotions and best sellers. We accept up to five different custom labels.
You'll be able to create product groups in Catalogs using custom labels.
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| custom_label_0 | Custom grouping of products | Max 1000 characters |
Bestsellers Summer promotion |
| custom_label_1 | Custom grouping of products | Max 1000 characters | |
| custom_label_2 | Custom grouping of products | Max 1000 characters | |
| custom_label_3 | Custom grouping of products | Max 1000 characters | |
| custom_label_4 | Custom grouping of products | Max 1000 characters |
| Column name | Description | Syntax/supported values | Example |
|---|---|---|---|
| ad_link | Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking – do not send tracking parameters only. At this time we do not support impression tracking. Must begin with http:// or https:// | string URL | |
| condition | The condition of the product. Must be one of the following values: ‘new’, ‘used’, ‘refurbished’. | new used refurbished |
new |
| google_product_category | The categorisation of the product based on the standardised Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. | See the English |
Clothing & Accessories > Clothing > Shirts & Tops 212 |
The
Remember the following when sending shopping specific fields through the Pinterest tag:
PageVisits, AddToCart and Checkouts PageVisit, AddToCart and Checkouts Use the
See our