It looks like you're viewing this from a region that Catalogs isn't available yet. See where Catalogs is available to Pinterest Business accounts. Learn more

Ready to upload your catalog, and get your products on Pinterest? Before you get started, you’ll need to get a business account and complete the following steps. Click a link below to jump to the section you need:

  • See if Catalogs is for you
  • Claim your website
  • Prepare your data source
  • Once you’ve set up Catalogs, install the Pinterest tag so you can create a shopping campaign.

    Alternatively, if you’re a developer, you can use the Pinterest API to create and manage your catalog on Pinterest. This option is suited to developers as it’s more advanced than the steps outlined below and requires specialist knowledge.

    Is Catalogs for you?

    Catalogs is a feed ingestion tool designed for businesses that sell products on their websites. Using Catalogs 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 catalog 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 to publish on Pinterest. We currently support the following integrations:

  • Shopify
  • WooCommerce
  • Lengow
  • ChannelAdvisor
  • GoDataFeed
  • Feedonomics
  • Productsup
  • If Catalogs is not right for you, you can promote your content in other ways on Pinterest. Learn how to create an ad from your profile

    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.

    Prepare your data source

    Before you can set up your feed, you have to create a data source. You can add up to 50 data sources to account for the promotion of your products across different markets, languages and currencies.

    What's a data source?

    A data source (also known as a product catalog, 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 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. 

    Maintaining a data source

    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 can mean your whole feed does not update, some items on your feed do not update, or you need to make some formatting changes. Learn more about troubleshooting error messages.

    Note: If you’re promoting Pins as ads and you update imagery for your entire catalog, delivery of your shopping ads or collections ads might be delayed by a day or two.

    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 this time.
  • Host your own data source on an FTP/SFTP/WebDAV 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 feed. If your data source (feed) 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.
  • Catalogs 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.

    Catalogs data source format requirements

    Supported formats:

  • Tab separated (TSV) (Download TSV example)
  • Comma separated (CSV) (Download CSV example)
  • XML (RSS 2.0, ATOM 1.0) (Download XML example)
  • 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.

    Formatting tips
  • If you're using a CSV, we recommend wrapping your values in double quotes to avoid any possible parsing issues
  • Additional floating delimiters (comma, tab) can result in the item or file not processing properly
  • Make sure delimiters for all 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 standardized American English for the required and set values
  • The data source file you’re uploading must be encoded in UTF-8 format (with the exception of GOOGLE_TSV_EXCEL files, which must be encoded in ISO_8859_1 format)
  • Product data requirements

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

    Required and optional fields

    There are seven required fields. Make sure to check that 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:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability
  • If you want to display variants in the product detail page, so people browsing your products can select relevant details like colors or sizes, these fields are required:

  • item_group_id
  • variant_names
  • variant_values
  • 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.

    Required fields

    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 color 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 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 send the accurate images. Make sure there are no template or placeholder images at the link. 

    The image link can have a maximum of up to 2000 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. 

      https://scene.example.com/image/image.jpg
    price

    The price of the product. The price must reflect the true cost of the product and 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 before or after the numeric price value, with or without 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
    Optional general attributes
    Column name Description Syntax/supported values Example
    product_type The categorization of your product based on your custom product taxonomy. Up to five subcategories must be sent separated by “ > “. The > must be wrapped by spaces. We do not recognize any other delimiters such as comma or pipe.

    L0 > L1 > L2 > L3 > L4

    Max 1000 characters

    Max five subcategories

    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 by the Pinterest user-agent, and send the accurate images. Make sure there are no template or placeholder images at the link.

    Each image link can have a maximum of up to 2000 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 update.

      "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg"
    mobile_link The mobile-optimized 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 before or after the numeric price value, with or without 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.     
    Optional product identifiers
    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. Max 100 characters Josie’s Denim optional
    GTIN The unique universal product identifier. It should follow GTIN guidelines. Numeric 3234567890126 optional
    mpn Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer. 

    Alphanumeric

    Max 70 characters

    "mpn":
    "PI12345NTEREST"
    optional
    Optional product characteristics
    Column name Description Syntax/supported values Example

    color

    The primary color 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

    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 &#44, 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 Color,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
    Optional tax and shipping data
    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 provide free shipping for the item or not. If you do, enter 0 as the free_shipping_limit. If you only offer free shipping 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 shipping. This is only relevant if you offer free shipping. 

    <numeric>

    <ISO 4217>

    35USD
    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 100 characters

    Best sellers

    Summer promotion

    custom_label_1 Custom grouping of products Max 100 characters  
    custom_label_2 Custom grouping of products Max 100 characters  
    custom_label_3 Custom grouping of products Max 100 characters  
    custom_label_4 Custom grouping of products Max 100 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 categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. See the English full taxonomy. Visit Google’s Help Center to access taxonomies for additional languages. Apparel & Accessories > Clothing > Shirts & Tops
    212

     

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

    Remember the following when sending 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 
  • The product_id must pass under a line item (will not be visible in Conversions view page)
  • 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 100,000 combined PageVisit and AddtoCart events in the last seven days passing back product IDs
  • Use the Tag Helper Chrome Extension to double-check that you have product IDs passing back on product detail pages.

    What's the next step?

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

    End of Other articles Links
    User feedback
    Was this article helpful?

    collection_fields

    How can we make this article better?