Add your data source

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

You need to add your data source URL to Pinterest so we can access your data source file and create Pins for your products. Before you do this, make sure you have prepared your data source and that you have claimed your website. If there are any errors with your data source file, you can learn how to troubleshoot them below.

You can add up to 20 data sources to one business account to promote your products across different markets, languages and currencies.

You can also delete a data source if you no longer want it on your account.

Note: if people on Pinterest have already saved Pins from your data source, deleting your data source will not delete the Pins saved to their boards.

Remember:

  • 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 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 your account manager.
  • When changing the image for a product, update the image URL to a different one. If you do not update the image URL, the image change will not be recognized.

Troubleshoot data source error messages

We use unique messages to let you know if something went wrong with product Pin creation or if we have a recommendation for you. There are three different message types you can expect: 

  • File-level error: Your entire data source may fail ingestion if your data source has any of the file-level errors listed below. 
  • Product-level error: If your product has failing errors, it will not be able to create product Pins. 
  • Product-level alert: Products with alerts will still create product Pins but we recommend you adjust the product data to avoid warnings.

You can troubleshoot these errors and alerts by following the below steps:

  1. Log into your Pinterest business account.
  2. Click Ads, then click Catalogs.
  3. Click the directional chevron down icon  next to the data source you want to troubleshoot.
  4. Click View issues. You’ll see a description of the issue and instructions for what to do. 
  5. Click the directional chevron down icon next to the error or alert number to see a list of items affected by the same issue.
  6. Click View more affected items to see the full list of affected items.
  7. Click the directional chevron down icon next to the titles of the items to view more information. 

Match the error message number you’re receiving with the number below for advice on how to update and correct your data source.

Error code Error message Error type What to do
3 Your data source was not ingested because it has not changed in the previous 90 days. File-level failure Update your data source before your next ingestion to ensure that your product information is accurate.
100 Your data source cannot be accessed. File-level failure Review your data source credentials and filepath.
Make sure that your file name has not changed on the location (for ftp/sftp).
Make sure that your hosting location is not timing out.
Make sure that you've include the username/password in the file URL.
101 Your data source uses an unsupported encoding format. File-level failure Re-encode your file to UTF-8 or Latin1.
 
102 Your data source contains formatting errors. File-level failure Make sure your file is delimited in either comma (double quote-wrapping recommended) or tab form. Make sure there are no additional or missing delimiters in each row.
103 Your data source is missing some required column headers. File-level failure Make sure you're sending all required column headers. Review the required data source specifications.
104 Some image links are formatted incorrectly.  Row-level failure Make sure your image link begins with http:// or https:// and is a valid URL.
105 Some items are missing an item ID in product metadata, so these items will not be published. Row-level failure ID is a required field. Make sure you're sending item ID for all rows in your data source. Remove any items with no IDs.
106 Some items are missing a title in product metadata, so those items will not be published.  Row-level failure Title is a required field. Make sure you're sending a product title for all rows in your data source. Remove any items with no titles.
107 Some items are missing a description in product metadata, so those items will not be published. Row-level failure Description is a required field. Make sure you're sending a description for all rows in your data source. Remove any items with no description.
108 Missing required attribute: Google product category – your products are missing Google product category values in the required Google product category attribute.  Row-level failure Send google_product_category following the right taxonomy. We currently only accept en-US taxonomy.
109 Invalid formatting required attribute: Google product category – your products do not include a valid Google product category.  Row-level failure Make sure you're following the correct taxonomy. We currently only accept en-US taxonomy.
110 Some items are missing a link URL in product metadata, so those items will not be published. Row-level failure Link is a required field. Make sure you're sending a product landing page.
111 Some items are missing an image link URL in product metadata, so those items will not be published. Row-level failure Image_link is a required field. Make sure you're sending an image link for your product.
112 Some items are missing an availability value in product metadata, so those items will not be published. Row-level failure Availability is a required field. Make sure you are sending one of: in stock, out of stock or preorder.
113 Some items have price value formatting errors in product metadata, so those items will not be published.  Row-level failure The Price field must be formatted as 'number' 'currency', e.g. 1.00 USD, 1 USD or 1.00USD.
114 Your title for this item is truncated because it contains too many characters.  Row-level warning We truncate the title if it's longer than 128 characters. To make sure that your title does not get trimmed, please send product titles that are less than 128 characters.
115 Your description for this item is truncated because it contains too many characters.  Row-level warning We truncate the description if it's longer than 500 characters. To make sure that your product description does not get trimmed, please send descriptions that are less than 500 characters.
116 Some items are missing a condition value or their condition value is formatted incorrectly, so some products will be published without a condition listed.  Row-level warning The accepted condition values for your product are: new, used or refurbished. Make sure that you are not sending any other values for the Condition column.
117 Some gender values are formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences.  Row-level warning Gender must be one of the following: male, female or unisex. Any other strings will be stripped from your product data and will impact relevancy for your product.
118 Some age group values are formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences.  Row-level warning The age_group must be one of the following: newborn, infant, toddler, kids or adult. Any other strings will be stripped from your product data and will impact relevancy for your product.
119 Some size type values are formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences.  Row-level warning The size_type must be one of the following: regular, petite, plus, big_and_tall or maternity. Any other strings will be stripped from your product data and will impact relevancy for your product.
120 Your data source contains formatting errors for some items.  Row-level failure Your data source contains formatting errors causing upload failure for one or more lines, which can also affect upload for your entire product feed. Check and correct any formatting errors before your next update to try again.
121 Invalid formatting required attribute: link – your product links contain UTM tracking parameters. Row-level warning Check that the UTM parameters are following our tracking guidelines and set up specifically for Pinterest.
122 Some links are formatted incorrectly. Row-level failure Make sure your link begins with http:// or https:// and is a valid URL.
123 Your product feed contains duplicate items.  Row-level warning The current row has a warning because the data source already contains an item with the same product ID. Do not send duplicates of your product.
125 Some items have sale prices listed that are higher than the original price of the item. Row-level warning The Sale price field must be formatted as 'number' 'currency', e.g. 1.00 USD, 1 USD or 1.00USD. Sale price cannot be higher or the same as the Price column. 
126 Some items only have one or two levels of Google product categories listed, which may limit visibility in recommendations, search results and shopping experiences. Row-level warning We recommend sending the full specific Google Product Category. More granular categories will help us better understand the product.
127 Some Adwords_redirect URLs are duplicates of the link URLs for that item. Row-level warning Confirm that the ad_link column is sending the right tracking parameters for Pinterest. We recommend sending organic links in the link column, and any URLs with tracking in ad_link.
129 Your data source contains duplicate headers. File-level warning Your data source contains duplicate column names. Remove duplicate columns and send unique columns only. We'll only accept the first column of the duplicate column if duplicates occur.
130 Your tax values for some items are formatted incorrectly.  Row-level warning Make sure your tax column is following the correct setup. All colons are required, even for blank attributes e.g. US::0.13:
131 Your shipping values for some items are formatted incorrectly.  Row-level warning Make sure your Shipping column is following the correct setup. All colons are required, even for blank attributes e.g. US:::0.00
132 Some items have invalid shipping weights.  Row-level warning The current line failed validation because the Shipping weight field is not in the following format: '3kg' or '3 kg'. The string must contain a numeric value first then a valid weight unit type (one of 'lb', 'oz' or 'kg').
133 Some items have invalid multi-pack values. Row-level warning Multipack value must be numeric. Any other strings will be stripped from your product data.
134 Some Adwords_redirect links are formatted incorrectly.  Row-level failure Make sure your ad_link link begins with http:// or https:// and is a valid URL.
135 Some Adwords_redirect links contain too many characters. Row-level failure Make sure your ad_link link is shorter than 511 characters and is a valid URL.
136 Your image link is formatted incorrectly, so this item will be published without an image.  Row-level warning Check for any issues with your image link's URL formatting or your hosting site and correct them before your next update.
137 Some image links are formatted incorrectly and will not be published with your item. Row-level warning We'll strip any additional_image_links that are not formatted correctly. Please make sure these are valid URLs.
138 Your data source contains too many items, so some items will not be published. File-level warning We only accept 20 million rows at the moment. Only the first 20 million products will be processed. Any additional products will be ignored. Send fewer than 20 million products to make sure that all of the products you want to be processed are accepted.
139 Your product links do not match the verified domain associated with this account. File-level failure Your link URLs must match the verified domain for your account. Make sure you're not sending any redirects or other domains in the Link column of your data source.
140 Your merchant domain needs to be claimed. File-level failure You must have a verified domain in order to ingest your data source. Verify your domain and try again.
141 Some items have invalid adult values. Row-level failure If you're including an 'Adult' column and have a value for the column, make sure it's one of: true, false, yes or no.
142 Your product link for this item was not published because it contains too many characters. Row-level failure Check your product link and make sure it's no longer than 511 characters before your next update. 
143 Your data source could not be validated because your .xml file is formatted incorrectly.  File-level failure Check for any formatting errors in your .xml file (missing end tags, invalid characters, etc.) and correct them before your next update.
144 Your expiry date is formatted incorrectly, so this item will be published without an expiry date.  Row-level warning Make sure your expiry date column entry is formatted numerically, and correct any other formatting before your next update.
145 Your availability date is formatted incorrectly, so this item will be published without an availability date.  Row-level warning Make sure your availability date column entry is formatted numerically, and correct any other formatting before your next update.
146 Your sale date is formatted incorrectly, so this item will be published without a sale date.  Row-level warning Make sure your sale date column entry is formatted numerically, and correct any other formatting before your next update.
147 Your weight unit is formatted incorrectly, so this item will be published without a weight unit.  Row-level warning Make sure your weight unit column entry is formatted as lb, oz or kg, and correct any other formatting before your next update.
148 Your bundle column entry is formatted incorrectly, so this item will be published without being bundled with other products.  Row-level warning Make sure your bundle column entry is formatted as yes, no, true or false, and correct any other formatting before your next update.
149 Your updated time column is formatted incorrectly, so this item will be published without an updated time.  Row-level warning Make sure your updated time column entry is formatted numerically, and correct any other formatting before your next update.
150 Your data source could not be downloaded due to URL redirect issues.  File-level failure Check for any issues with your data source URL's formatting or your hosting site and correct them before your next update. Your data source URL may have exceeded 10 redirects, changed protocols during a redirect, or may be completely invalid.  
151 This item will not be published because price information is required.  Row-level failure Enter correct price information in the price column before your next update.
152 Your data source could not be validated because your file does not contain the minimum number of lines required for a valid data source.  File-level failure Make sure your data source contains at least two or more lines (a header line and one or more product lines) before your next update.
153 Your custom label is too long, so this item will be published without a custom label.  Row-level warning Make sure your custom label is no longer than 100 characters before your next update.
154 Your product type is too long, so this item will be published without a product type.  Row-level warning Make sure your product type is no longer than 750 characters before your next update.
155 Your catalog could not be validated because there are no products in your Shopify store to ingest.  File-level failure Check your product listings in your Shopify store and confirm that you have items for sale before your next update.
156 Your additional image links exceed the limit for additional images, so this item will be published without some of your images. Row-level warning Limit entries in the additional links column to 10 or less.
157 Some Google product category values are missing, which may limit visibility in recommendations, search results and shopping experiences. Row-level warning Check your Google product category values and make sure they're formatted with values from the US-EN GPC taxonomy for any items with associated Google product category values before your next update.
158 Some Google product category values are formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences. Row-level warning Check your Google product category values and make sure they're formatted with values from the US-EN GPC taxonomy for any items with associated Google product category values before your next update.
159 Some condition values are missing, which may limit visibility in recommendations, search results and shopping experiences. Row-level warning Check your condition values and make sure they are formatted as new, used or refurbished for any items with associated condition values before your next update.
160 Some condition values are formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences. Row-level warning Check your condition values and make sure they're formatted as new, used or refurbished for any items with associated condition values before your next update.
163 Some availability values were formatted incorrectly and have been automatically corrected. Row-level warning Enter availability values for all items or delete items that are missing availability values before your next update.
164 Some condition values were formatted incorrectly and have been automatically corrected. Row-level warning Enter condition values for all items or delete items that are missing condition values before your next update. Condition values have to be formatted as new, used or refurbished.
165 Some gender values were formatted incorrectly and have been automatically corrected. Row-level warning Check that your gender value entries are formatted as male, female or unisex before your next update.
166 Some age_group values were formatted incorrectly and have been automatically corrected. Row-level warning Check that your age_group value entries are formatted as newborn, infant, toddler, kids or adult before your next update.
167 Some size_type values were formatted incorrectly and have been automatically corrected. Row-level warning Check that your size_type value entries are formatted as regular, petite, plus, big_and_tall or maternity before your next update.
168 Some of your utm_source values were formatted incorrectly. Those values have been automatically corrected to `pinterest` in order to ensure accurate UTM attribution. Row-level warning Review your utm_source values and make sure they're entered as ‘Pinterest’ to ensure accurate UTM source attribution.
169 Your item's currency does not match the usual currency for the location where your products are sold or shipped. Row-level warning Update your item's currency to match the location where your products are sold or shipped if this is incorrect. If your item's currency is correct, no action is needed.
1001 Some images cannot be found. Row-level failure Make sure your image link is a link to an image file and can be downloaded by a user-agent.
1007 Some images have unacceptable formats. Row-level failure Send valid image URLs with image files in the destination.
1012 This item will not be published because the maximum number of items in this group has been exceeded.  Row-level failure Reduce the number of items listed for this group to 350 or less.
4023 Your item does not meet Pinterest's merchant guidelines, so it will not be published. Row-level failure Review Pinterest's Merchant Guidelines and, if possible, correct the issues your item may have so that it may publish on your next ingestion.
4028 Some main images cannot be found. Row-level failure Check for any issues with your main image's URL formatting or your hosting site before your next update.
4029 Some additional images cannot be found. Row-level warning Check for any issues with your additional images' URL formatting or your hosting site before your next update. 
4042 Your item does not meet Pinterest's merchant guidelines, so it will not be published. Row-level failure Review Pinterest's Merchant Guidelines and, if possible, correct the issues your item may have so that it may publish on your next ingestion.
4059 Your item's description is not translated for this region.  Row-level failure Pinterest was not able to to ingest this item because there's no translation for its product details in your feed. Learn more about setting up translations for your store.

What's the next step?

Once your data source has been ingested successfully, learn how to Create product groups. If your data source has not been ingested successfully, check out how to troubleshoot data source error messages.

Still need help?
Contact us