Pinterest Catalog CSV Template and Field Guide

The Pinterest catalog CSV template

Want the file ready-made? Our free Pinterest Catalog CSV Template Generator builds it with just the columns you choose, plus example rows.

Copy this header row exactly - Pinterest matches columns by name - and add one row per product underneath:

id,title,description,link,image_link,price,availability,condition,brand,google_product_category,product_type,item_group_id,color,size,custom_label_0
SHIRT-77-NVY-M,"Classic Crew Neck T-Shirt - Navy, M","Soft 100% cotton crew neck t-shirt with a relaxed fit.",https://yourstore.com/products/classic-crew-tee,https://yourstore.com/images/classic-crew-tee-navy.jpg,24.00 USD,in stock,new,Tidewater Apparel,212,Apparel > Shirts,SHIRT-77,Navy,M,Summer Sale

Values that contain commas - like the title and description above - must be wrapped in double quotes. Save the file as UTF-8 so accented characters and symbols come through correctly.

Required fields

The diagram at the top of this guide summarizes them. Every row needs:

• id - a unique ID for the product, up to 127 characters. Never reuse an ID for a different product.
• title - up to 500 characters. Include variant details such as color and size so each variant's title is distinct.
• description - up to 10,000 characters, plain text (no HTML).
• link - the product page URL, up to 511 characters, starting with http:// or https://. It must be on a website you've claimed on Pinterest.
• image_link - the main product image URL. Pinterest recommends large images (at least 1000 x 1500 pixels), and the image must be reachable by Pinterest's crawler - no placeholders.
• price - a number and an ISO 4217 currency code, such as 24.99 USD.
• availability - exactly in stock, out of stock, or preorder.
• item_group_id - required only for products with variants. Every variant of the same product shares one value.

Optional fields worth filling in

• condition - new, used, or refurbished.
• brand - your brand or the manufacturer's.
• google_product_category - a category from Google's product taxonomy, as its numeric ID or full path. Our free Google Product Category Lookup tool finds both.
• product_type - your own category path, such as Apparel > Shirts.
• sale_price - must be lower than price.
• additional_image_link - up to 10 extra image URLs.
• color, size, gender, age_group - especially useful for apparel.
• custom_label_0 to custom_label_4 - your own labels (up to 511 characters each), used later to build product groups for shopping ads. See Product Groups and Shopping Ads.

How to list variants

Give every color and size its own row with its own id, put the shared parent value in item_group_id, and fill in color and size. A t-shirt in two colors and three sizes is six rows, all with the same item_group_id.

Before you upload

1. Check that every row has all seven required fields and that IDs are unique.
2. Make sure prices include the currency code and availability uses the exact wording.
3. Open a few links and image URLs to confirm they load.
4. Run the file through our free Product Catalog CSV Validator to catch missing or invalid fields before Pinterest does.

Then add it to Pinterest as your Pinterest data source - by uploading it, or hosting it at a URL Pinterest re-reads about once a day. If Pinterest still reports problems, How to Fix Pinterest Catalog Errors covers each error code. New to catalogs? Start with What Is a Pinterest Catalog?