Skip to content

Pinterest catalog diagnostics

Settings → Pinterest → Diagnostics shows what Pinterest says about the catalog Máximo has pushed: which items it rejected, which it accepted with reservations, and anything holding your catalog back from full shopping distribution.

Catalog sync tells you whether Máximo successfully sent your products. Diagnostics tells you what Pinterest did with them, which isn’t the same thing. An item can upload cleanly and still be held out of shopping surfaces.

Two kinds of issue

Section titled “Two kinds of issue”

Item validation issues come back synchronously in Pinterest’s response to every catalog upload, and Máximo records them per product as it syncs:

  • Errors are blocking. Pinterest didn’t ingest the item at all. Something in the data it received is invalid.
  • Warnings are non-blocking. The item is live, but Pinterest has flagged an attribute that would help if you fixed it.

Each issue names the attribute it came from, so it points at a specific field on a specific product rather than at the sync as a whole. Fixing one is usually a matter of an override or a per-destination override on the product itself.

Distribution issues are account-level, and come from a report Pinterest builds asynchronously. These are the reasons items are held back from full shopping distribution rather than outright rejected, and an unclaimed domain is a common one. See claiming your domain.

Why the page doesn’t call Pinterest live

Section titled “Why the page doesn’t call Pinterest live”

Pinterest generates the distribution report once per day, and building one takes minutes rather than milliseconds. So this tab reads the snapshot that Máximo’s daily capture already stored, rather than requesting a fresh report every time someone opens the page. Nothing on this page waits on Pinterest.

Refresh queues a new capture rather than running it in the request. The tab then polls itself until the new snapshot lands, so you can leave it open and watch for the result.

Section titled “Related”