Fix Pinterest Catalog feed issues
Every common Pinterest Catalog feed issue, with canonical wording and step-by-step fixes.
Missing google_product_category
BlockingPinterest Catalog requires google_product_category — it uses Google's published taxonomy directly. Items without it can't enter the catalog. Pinterest is stricter than Google on this; what's optional for Google is required for Pinterest.
Affects: google_product_category
Image cannot be retrieved
BlockingPinterest can't fetch the image at image_link. Common cause for Pinterest specifically: tall-format requirements (Pinterest prefers 600×900+) combined with thumbnails being served.
Affects: image_link
Landing page returns an error
BlockingPinterest's crawler can't reach the product page. 404, redirect to non-product page, blocked by robots.txt, or HTTPS issues. Items with broken landing pages can't serve as shopping pins.
Affects: link
Price doesn't match landing page
BlockingPinterest verifies feed prices against landing-page prices. Mismatches block the item from shopping pin distribution. Pinterest's check is slightly more forgiving than Google's but still tight.
Affects: price
Missing availability
BlockingPinterest Catalog requires availability on every item. Without it, the item can't enter the catalog. Pinterest treats missing availability stricter than missing-but-invalid availability — the latter at least makes it into the catalog as 'out of stock'.
Affects: availability
Missing brand
BlockingPinterest Catalog requires brand on every item. Without it, products can't be matched against Pinterest's brand registry and don't serve in branded-pin placements.
Affects: brand
Missing condition
WarningPinterest expects condition (new, refurbished, used) for catalog items. Missing condition defaults to 'new' in some surfaces but suppresses filterable visibility.
Affects: condition
Restricted content
PolicyThe product falls under Pinterest's restricted-content policy. Pinterest's policy is stricter than Meta's on some categories (weight loss, body image, financial products, alcohol).
Catalog not verified
BlockingPinterest requires merchant verification before catalog products can serve as shopping pins. Unverified catalogs can be created but products don't appear in shopping placements.
Missing link
BlockingItem is missing the link field. Pinterest can't surface as a shopping pin without a destination URL. Items with no link don't enter the catalog.
Affects: link
Invalid image format
BlockingPinterest can't process the image format. Supports JPG, PNG, WebP — but not GIF (Pinterest treats animated content separately), BMP, or SVG.
Affects: image_link
Imagery violates policy
PolicyPinterest's image policy is stricter than Meta or Google on body imagery, suggestive content, and certain wellness claims. Items with policy-violating imagery don't serve.
Affects: image_link
Verified Merchant Program review pending
WarningYou've submitted for the Verified Merchant Program but Pinterest hasn't approved yet. Catalog products still serve (if otherwise valid) but without the Verified Merchant badge and associated placement benefits.
Duplicate items in feed
WarningMultiple feed rows share the same id. Pinterest keeps the first match and drops the rest. Hidden inventory gap because the dropped rows don't appear in error reports.
Affects: id
Feed XML invalid
BlockingPinterest can't parse the feed XML. Schema validation failed — could be malformed tags, encoding issues, or invalid characters in field values.
Shopping pin disabled
WarningItem exists in the catalog but the Shopping Pin feature is disabled — likely because of category restrictions, verification gaps, or trust-signal issues. Items appear as regular pins but without buy functionality.
Missing availability per region
WarningItem's availability field is set but doesn't specify region-level inventory state. Items targeting multiple regions need per-region availability for accurate placement.
Affects: availability
Catalog file too large
BlockingFeed file exceeds Pinterest's size limits — typically around 1GB uncompressed or 200MB compressed. Items can't sync until file is split.