Connect Pinterest catalog and Tag

Connecting Pinterest gives you a product catalog for Pinterest shopping surfaces, plus the Pinterest Tag and Conversions API for tracking. All three share a single Pinterest authorization.

Connect your Pinterest account

1. Go to Settings → Pinterest → Connection.
2. Select Connect Pinterest. This opens Pinterest’s authorization flow in a popup.
3. Grant access to the Pinterest account that should own your catalog and Tag.

Máximo requests catalog, ads, and user-account scopes in one grant, covering catalog sync, the Pinterest Tag, and the Conversions API together. Reconnecting re-authorizes all three at once.

Connecting also mints a separate, narrower conversions token that Conversions API delivery uses, stored independently of the catalog credentials, so event delivery never depends on the catalog token’s refresh cycle. If that step fails, catalog sync still connects and the Pixel tab tells you the token needs to be reminted.

Choose an ad account

If your Pinterest login can operate more than one ad account through Business Access, the Connection tab shows a picker once you’re connected. Choose the one Máximo should sync to and send events for. Switching ad accounts re-checks catalog state for the new account, so a verdict from the old one is never carried over.

Claim your domain

Pinterest requires a claimed domain for full shopping distribution of your catalog items. The Connection tab shows one of three states:

• Claimed: your storefront domain is verified and your catalog gets full shopping distribution.
• Not claimed: catalog sync keeps running, but items may be held back from full shopping distribution. Select Claim domain on Pinterest and Máximo fetches Pinterest’s verification code, adds the p:domain_verify meta tag to your storefront through the Máximo theme app embed, and asks Pinterest to verify. Your storefront can take a minute to pick the tag up, so if the first check fails, select Verify domain again.
• Unavailable: Máximo couldn’t reach Pinterest to check right now. This doesn’t affect catalog sync, and it isn’t the same as “not claimed”.

The automatic claim needs the Máximo theme app embed enabled. You can also claim manually in Pinterest Business → Settings → Claimed accounts → Claim website, using the same domain your storefront serves from.

Set up catalog sync

Settings → Pinterest → Catalog pushes your live catalog to Pinterest one market at a time. Turn sync on, then set a schedule on the same tab to control how often Máximo pushes updates.

When catalog sync is blocked by an existing feed

Pinterest only accepts catalog uploads from ad accounts that have no other feed data source. The most common conflict is Pinterest’s own Shopify sales channel app: if it’s installed and has registered a product feed, Máximo’s catalog sync can’t enable itself for that ad account, and the Catalog tab shows a blocking banner.

To clear it:

1. In Pinterest Business, go to Catalogs → Data sources.
2. Remove the feed data source registered against the ad account you connected to Máximo.
3. Return to the Catalog tab and enable sync again.

Máximo re-checks on every Catalog tab load and on ad-account switch, so the banner clears itself once the feed is gone, and comes back if a feed is added later. Your Pinterest Tag and Conversions API are unaffected by a feed conflict, only catalog sync is blocked.

Markets, country, and language

Pinterest localizes catalogs per request rather than per item: every batch Máximo sends for a Shopify market carries one country and language pair, resolved from that market’s primary country and content language. The Catalog tab’s market table shows each enabled market with its resolved country, language, and presentment currency.

Country and currency are read-only, resolved from the market itself. Language defaults to Auto, which picks Pinterest’s best match for that market’s language and falls back to en-US if nothing matches. If that isn’t the locale you want, choose one of Pinterest’s supported values from the dropdown and select Save languages.

Each market gets its own catalog record, so per-destination overrides apply to every market, not just your primary one. See markets per destination.

Refresh cadence and the 90-day expiry

Pinterest expires catalog items that go 90 days without a refresh. Máximo pushes changed items as they change, and runs a full catalog walk at least every 30 days that re-sends every item whether or not its data changed. So a quiet week with few product changes doesn’t mean sync has stalled, it means nothing needed pushing. The 30-day cadence leaves roughly 50 days of margin before an item could approach expiry, even if a full walk is missed once or twice.

Turn on the Tag

Settings → Pinterest → Pixel manages the browser Tag and the server-side Conversions API together, since they share one Conversion Tag ID and deduplicate against each other.

Pinterest recommends exactly one Conversion Tag per ad account, because a second tag splits your audiences and event history across two identities. The tab reflects that:

• It lists the Conversion Tags that already exist on your connected ad account, and auto-selects the tag when there’s exactly one.
• If you have more than one, you choose which one Máximo should use.
• If your ad account has no tags yet, Create a tag for me creates one with enhanced match enabled and starts using it immediately.

Once a tag is configured, three toggles unlock: Enable Pinterest Pixel, Enable Conversions API, and Enable Enhanced Match. See event delivery for what each one sends.

Enable the storefront embed

The Tag only fires once the theme app embed is on:

1. In Shopify admin, go to Online Store → Themes → Customize.
2. Open App embeds.
3. Enable Máximo Pixels.

This single embed covers Meta, TikTok, Google, and Pinterest. You only need to turn it on once, however many of these destinations you connect. It also carries the p:domain_verify meta tag used by the automatic domain claim above.

Next steps

• Event delivery: which events reach Pinterest, and how to verify them.
• Event quality: Pinterest’s own scoring of the signal you send.
• Catalog diagnostics: distribution issues Pinterest reports back.
• Pixel presence: confirm the Tag is actually firing on your storefront.