Before you get started with Catalogues

It looks as though you're viewing this from a region where Catalogues isn't available yet. See where Catalogues is available to Pinterest Business accounts.

Learn more

Before you can set up Catalogues, you need to complete these steps. Click a link below to jump to the section you need:

Is Catalogues for you?

Catalogues is a feed-ingestion tool designed for businesses that sell products on their websites. Using Catalogues requires:

  • A Pinterest business account
  • A claimed website
  • A website that meets our Merchant Guidelines, with a clear and easy-to-find shipping policy, refund policy, and contact details
  • A data source or a file that contains a list of your products and their corresponding attributes (may also be called a product catalogue or product feed)
  • Data source hosting or a way to consistently host and store a data source of your products that you can send to Pinterest daily

If you’d like assistance with the above steps, you can partner with an e-commerce site that will format your products for publication 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 Create an ad from your profile

Data source overview

What's a data source?

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 dynamically create Pins from your products.

How a data source works

To submit a data source to Pinterest, you provide a URL link from which we can access your data source file. We'll validate the file and create a product Pin for each item that passes our validation. See more about data source requirements.

Maintaining a data source

Hosting a data source starts an ongoing process to provide updated information about the products you have available. Pinterest will ingest your data source daily, and warn 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 does not update, some items on your feed do not update, or you may need to make some changes to align with best practices. Learn more about troubleshooting error messages.

More about data sources:

  • We ingest your data source once every 24 hours. Make your updated full data source available daily to keep your product details up to date. Scheduled data source updates are available but on-demand ingestion is not supported at present.
  • Host your own data source on an FTP/SFTP server or with an HTTP/HTTPS direct download link. This needs to be accessible by a user-agent, and cannot require IP or SSH key whitelisting. If you're using a direct download link, there cannot be any extra navigation required for Pinterest to access the file. We do not provide data source hosting.
  • We can process up to 20 million products per account. If your data source has more than 20 million products, we'll process the first 20 million rows. To process more than 20 million rows for your catalog, contact us.
  • There’s a limit of one data source per business account.

Claim your website

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 Claim your website.

Set up the Pinterest tag

The Pinterest tag is a piece of JavaScript code you put on your website to gather conversion insights and build audiences to target based on actions people have taken on your site.

Make sure you send shopping-specific fields through the Pinterest tag.

  • The Pinterest tag has to be implemented with the following conversion types: PageVisits, AddToCart and Checkouts 
  • The Pinterest tag has to pass event data for “product_id” as an attribute for PageVisit, AddToCart and Checkouts
  • Product_id must pass under a line item (will not be visible on Conversions view page)
  • Use the Tag Helper Chrome Extension to double-check that you have product IDs passing back on product detail pages
  • The product_id data passed in the tag has to match the "item_group_id" or "id" provided in the data source
  • You must have a minimum of a combined 100,000 PageVisit and AddtoCart events in the last seven days passing back product IDs
     

Prepare your data source

Before you can set up your feed, you need to create a data source – a file that contains a list of your products and their corresponding attributes.

Catalogues data source hosting requirements

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.

Catalogue data source format requirements

Supported formats:

Formatting tips:

  • If you're using a csv, we wrap your values in double quotes to avoid any possible parsing issues
  • Additional floating delimiter (comma, tab) can result in the item or file not processing properly
  • Make sure that delimiters for all of your columns and rows are correctly set up by checking that you have the same number of delimiters in each row
  • The specifications for the feed must follow standardised American English for the required and set values
  • For tab-delimited or comma-delimited files, the data source file must be plain text, UTF-8 or Latin1 encoded

Product data requirements

Make sure that you follow our Merchant Guidelines. We may remove products or accounts that violate these guidelines.

Required and optional fields

There are seven required fields. If any of these fields are missing, or not properly formatted, your entire feed will fail ingestion.

Required fields:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

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.

Required fields

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 https://www.example.com/cat/womens-clothing/denim-shirt-0294
image_link

The link to the product image. The URL must be accessible by a user-agent and must send the accurate image. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://

Commas must be encoded or removed if they are part of the image link, as we're unable to process image links containing commas.

  https://scene.example.com/image/image.jpg
price The price of the product. The price should include currency in ISO-4217 if it's not US dollars. If the currency is not included, we default to US dollars. We accept currency 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.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
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

Optional general attributes

Column name Description Syntax/supported values Example
product_type The categorisation of your product based on your custom product taxonomy. Subcategories must be sent separated by “ > “. The > must be wrapped by spaces. We do not recognise any other delimiters such as comma or pipe.

L0 > L1 > L2 > L3 > L4

Max 1000 characters

Clothing > Women’s > Shirts > Denim
additional_image_link

The links to additional images for your product. Separate each additional image with a comma. We recommend enclosing the whole string with quotes. Must begin with http:// or https://

Commas must be encoded or removed if they are part of the image link, as we're unable to process image links containing commas.
 

We will create a new pin for every additional image link sent.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg"
mobile_link The mobile-optimised version of your landing page. Must begin with http:// or https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294
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's not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without a space. We do not accept 0 values. Do not use currency symbols.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP

Optional product identifier

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. 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

Optional product characteristics

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
UK

Optional tax and delivery data

Column name Description Syntax/supported values Example
tax Each tax attribute group can consist of 4 sub-attributes: country:region:rate (required):tax_ship
All colons, even for blank values, are required.
country:region:rate(required):tax_ship US:1025433:6.00:y
shipping Each delivery attribute group can consist of 4 sub-attributes: country, region, service 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

Optional adult product flag

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

Optional custom labels

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  

Optional shopping ad fields

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 https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest
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. Full taxonomy Clothing & Accessories > Clothing > Shirts & Tops
212

 

What's the next step?

See our Add your data source guide to learn how to connect your product feed to Pinterest.

Still need help?
Contact us