ToolsFeaturesPricingAPIGuidesBlogAboutFAQContact

Pinterest Catalog Feed Checker

Paste your catalog’s header row and a few products, as CSV or TSV, or one XML item. See what Pinterest’s own catalog rules would refuse before you upload it. Nothing is uploaded or fetched.

An example with problems is showing.

Or try an example

The example feed

Pinterest would refuse this catalog: 7 problems to fix

Pinterest’s rule: Your retail catalog needs to include the following fields, formatted exactly as you see them. If they’re missing, or formatted incorrectly, your entire retail catalog will fail ingestion.

    Every rule is from Pinterest Business Help, Get started with retail catalogs, checked 3 October 2026. Your feed is read on your device: it is never uploaded, its links are never opened, and the link to this page never includes it.

    Quick answer: Pinterest needs seven columns in every retail catalog, written exactly as it writes them: id, title, description, link, image_link, price and availability (plus item_group_id when products have variants). Its help says that if they are missing or formatted incorrectly, the entire catalog fails. Paste your feed’s first rows above to see what it would refuse: a price with a currency symbol, a description in HTML, a link without http://, a value Pinterest does not list.

    How to use it

    1. Open your feed (the CSV, TSV or XML file your shop or feed app makes) and copy the header row and a few products. Or copy one <item> from an XML feed.
    2. Paste it in the box. The checker reads it on your device and lists every problem by product and column.
    3. Fix the red ones first. Those are Pinterest’s required fields: one of them wrong fails the whole catalog. The amber ones are worth tidying.

    Pinterest’s required fields

    • id: a unique ID for each product, up to 127 characters.
    • title: the product’s name as on its page, including variant details such as colour and size, up to 500 characters.
    • description: up to 10,000 characters, in plain text (not HTML). For HTML there is a separate description_html column.
    • link: the product’s own page, starting with http:// or https://, up to 511 characters.
    • image_link: the main image, up to 2,000 characters, starting with http:// or https://, with no commas: Pinterest says to encode or remove commas.
    • price: a number with its ISO 4217 currency code before or after it, such as 24.99 USD or GBP 24.99. Without a code Pinterest reads US dollars. Do not use 0 values or currency symbols.
    • availability: one of in stock, out of stock or preorder.

    Optional columns such as brand, condition, gender, size_type and product_type have their own limits and lists of values, and the checker reads those too.

    Formatting tips from Pinterest

    • If you're using a CSV, we recommend wrapping your values in double quotes to avoid any possible parsing issues. A comma inside an unquoted value splits it into two columns.
    • Check that you have the same number of delimiters in each row and column.
    • The file must be saved as UTF-8.

    FAQ

    What fields are required for a Pinterest catalog?
    id, title, description, link, image_link, price and availability, plus item_group_id when products have variants. Pinterest says the column names must be written exactly that way.
    Why did Pinterest reject my catalog?
    Most often a required column is missing or misspelled, a price has a currency symbol or is 0, the description has HTML in it, or availability uses a word Pinterest does not list. Paste the first rows above to find which.
    Can I use Google Shopping’s feed for Pinterest?
    Often, because the column names are the same. Check the values Pinterest lists: for example, Pinterest writes availability as “in stock”, with a space.
    Is my feed uploaded?
    No. It is read by your browser, on your device. Its links are not opened, and the link to this page never includes it.