Product catalog mapping

Stripe Sync maps one Stripe Price = one HubSpot Product, so bookings and revenue land on clean line items.

The rule

• Each Stripe Price maps to exactly one HubSpot Product. Stripe's Product (the parent) carries name/description; the Price carries amount, currency and interval — the HubSpot Product represents the sellable item.
• Every Deal line item created for a subscription references the mapped HubSpot Product, which is what makes HubSpot revenue reports correct.

How mappings get decided

When a Stripe Price first appears (live webhook or historical import), it goes through this ladder:

1. Existing mapping — if the Price is already mapped, done.
2. Auto-link (opt-in) — if exactly one HubSpot Product matches by name (case-insensitive, trimmed), link it automatically.
3. Auto-create (opt-in) — if no match, create a new HubSpot Product from the Stripe Product's name/description.
4. Pending queue — otherwise the Price waits in Products → Pending in the dashboard for a human decision.

Both automations are opt-in defaults-off because a messy Stripe catalog can fan out into HubSpot. The onboarding wizard lets you set them; you can change them later in Settings.

The product pending queue

Dashboard → Products → Pending lists every unmapped Price with its Stripe name and the candidate HubSpot matches. For each, choose:

• Link — pick an existing HubSpot Product;
• Create — make a new HubSpot Product from the Stripe data;
• Ignore — never map it (e.g. internal/test prices). Ignored prices can be re-enabled later.

Deciding once applies to past and future bookings using that Price — the historical import re-checks pending mappings as you clear them.

Changing a mapping

Relinking a Price to a different HubSpot Product applies going forward; historical line items stay exactly as they were delivered (see Core concepts — no re-delivery). If you need history re-pointed, contact support before relinking.

Product renames

By default, renaming a Stripe Product does not rename the linked HubSpot Product — HubSpot owns its marketing copy. Enable Propagate product renames in Settings to mirror names (opt-in; it fans out to every linked Product).