‹ All supported channels
Pinterest Feed Specifications
Monthly visitors
322 million
2019 revenue
1.14 billion USD
Headquarters
San Francisco, California
International or Domestic
International
Ready to reach a whole new audience? Let us help you get your products listed on Pinterest.
About Pinterest
Pinterest is a free website where users can upload and store images as well as other media content.
Set up a Pinterest business account for free to access Pinterest Analytics and other tools that can help grow your presence on the platform. Check out Pinterest Shopping Ads
How to get set-up on Pinterest
- Create a Pinterest business account here: https://www.pinterest.com/business/create/
- Fill out your email, password and business name then select a business type
- Click “Create account”
A step-by-step guide to data source setup
- Navigate to Catalogs (catalogs.pinterest.com)
- Click “Get Started”
- Click “Add data source”. You must have a claimed domain in order to add a data source.
- Input your data source URL (must begin with http://, https://, ftp://, or sftp://, and include the full filepath and no credentials in the URL).
- Select the file format (CSV or TSV)
- Select “My data source is password-protected” if your data source requires credentials, and input credentials.
- Click “Create Pins”.
- You will be then navigated to the main Data Source page. Wait for confirmation email from Pinterest for the status of your data source submission.
Overview
Once a data source is submitted to Pinterest, they will validate the file, and submit products for Pin creation as long as they meet Pinterest’s specifications. Any errors with the file will be surfaced for you to fix. You can find the complete list of error messages here. Pinterest will then create a product Pin for each item within the data source. Every time the data source is refreshed and Pinterest ingests a new data source, the updated information will be reflected for that product. It is recommended that you send Pinterest an updated full data source daily to ensure that details of your products are up-to-date.
Data source setup requirements
- Prepare a data source file according to Pinterest’s data source specification.
- Make the data source file available at a permanent file path on your server via a HTTP, HTTPS, or FTP, SFTP request.
- Input the URL for the data source in the Catalogs interface, with the appropriate username and password credentials as necessary.
- The file path should be static. Any update to the file path must be updated by you to ensure that Pinterest is able to grab the file dynamically.
Required Pinterest feed fields
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| id | The user-created unique ID that represents the product. Only unicode characters are accepted. | Max 127 characters | DS0294-L | required |
| 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 128 characters | Women’s denim shirt, large | required |
| description | Description of the product. This field does not support HTML and must be in plain text for optimal experience. | Max 500 characters | Casual fit denim shirt made with the finest quality Japanese denim. | required |
| link | The landing page for the product. The link must lead directly to the same product and showcase the same data. We recommend against hardwalls. The URL must start with http:// or https:// | Max 511 characters | required | |
| image_link | The link to the product image. The URL must be accessible by a user-agent, and 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 currently we are unable to process image links containing commas. | required | ||
| price | The price of the product. The price should include currency in ISO-4217 if it is 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 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 | required |
| 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 | required |
| condition | The condition of the product. Must be one of the following values: ‘new’, ‘used’, ‘refurbished’. | new used refurbished | new | required |
| 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. | Full taxonomy | Apparel & Accessories > Clothing > Shirts & Tops 212 | required |
Optional general attributes
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| product_type | The categorization of your product based on your custom product taxonomy. 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 | Clothing > Women’s > Shirts > Denim | optional |
| additional_image_link | The links to additional images for your product. Separate each additional image with 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 currently we are unable to process image links containing commas. We will create a new pin for every additional image link sent. | optional | ||
| mobile_link | The mobile-optimized version of your landing page. Must begin with http:// or https:// | Max 511 characters | optional | |
| 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 US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without 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 |
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 alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer. | Alphanumeric | “mpn”: “PI12345NTEREST” | optional |
| identifier_exists | Required when unique product identifiers (GTIN or MPN) do not exist. When the attribute is not specified, the default value will be TRUE. | true false yes no | true | optional |
Optional product characteristics
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| color | The primary color of the product | blue | optional | |
| gender | The gender associated with the product. Must be one of the following values if sent: ‘male’, ‘female’, ‘unisex’ | male female unisex | female | optional |
| age_group | The age group to apply a demographic range to the product. Must be the one of the following values: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ | newborn infant toddler kids adult | adult | optional |
| material | The material used to make the product. | cotton | optional | |
| pattern | Description of the pattern used for the product. | plaid | optional | |
| size | The size of the product. | M | optional | |
| size_type | Additional description for the size. Must be one of the following values if sent: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ | regular petite plus big_and_tall maternity | regular | optional |
| size_system | Indicates the country’s sizing system in which you are submitting your product. | Country code | US UK | optional |
Optional tax and shipping data
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| 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 | optional |
| 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 | optional |
| 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 | optional |
| 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 | optional |
| 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 |
Optional adult product flag
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| adult | Set this attribute to TRUE if you are submitting items that are considered “adult”. These will not be shown on Pinterest. | TRUE FALSE | true | optional |
Optional custom labels
Custom grouping of products. These can be used for a variety of purposes such as seasonal, promotions, best sellers. We accept up to 5 different custom labels.
You will be able to create product groups in Catalogs using custom labels.
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| custom_label_0 | Custom grouping of products. | Best sellers Summer promotion | optional | |
| custom_label_1 | Custom grouping of products. | optional | ||
| custom_label_2 | Custom grouping of products. | optional | ||
| custom_label_3 | Custom grouping of products. | optional | ||
| custom_label_4 | Custom grouping of products. | optional |
Optional shopping ad fields
| Column name | Description | Syntax/supported values | Example | Requirement |
|---|---|---|---|---|
| adwords_redirect | 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 | optional |
What formats does Pinterest accept?
Files should be sent in either Tab Delimited (TSV) or Comma Delimited (CSV) format. If you use a CSV file, it is recommended that you wrap all of your values in double quotes to avoid any possible parsing issues.
How to send your product feed to Pinterest
Files should be made available on your server via HTTP, HTTPS, SFTP or FTP. You will need to give details of URL where the file can be retrieved from.
Feedonomics is an approved Pinterest Partner.
We can help get your products onto Pinterest and ensure you get the most out of your Pinterest Shopping Ads
Monthly visitors
322 million
2019 revenue
1.14 billion USD
Headquarters
San Francisco, California
International or Domestic
International
Ready to reach a whole new audience? Let us help you get your products listed on Pinterest.
Find out why over 30% of the top 1,000 Internet Retailers choose Feedonomics.
Check out our success stories
Large Department Store
Find out how Impression Share skyrocketed by over 200% with a 117% increase in Revenue.
Automotive
Find out how our agency partners Subaru campaign generated over $1 million in sales within 4 months.
Agency
Find out how ROAS increased 184% on shopping campaigns after converting 29 feeds from a legacy feed platform.