A product shows "size unclear" or won't let a shopper add to cart from the chart

This is the add-to-cart mapping state surfacing to a shopper — here's what each state means and how to fix it.

When a shopper selects a row in the size chart, Storely tries to resolve that row against a real product variant so it can add it straight to the cart. That resolution can land in one of four states:

  • Mapped — the row cleanly matches one real variant. Add to cart works normally.
  • Pending — Storely hasn't finished resolving the row yet; this usually clears on its own on page load.
  • Stale — the row used to map to a variant that has since changed or been removed (for example, a size was deleted from the product). Re-saving the product's variant options or re-linking the chart's template usually resolves this.
  • Ambiguous — the row could match more than one variant, most often on multi-option products (for example, a size that comes in more than one color). Storely handles this with a follow-up chip picker so the shopper can finish narrowing it down; if it isn't appearing, check that all of the product's option values are set on every variant.

If a merchant reports "size unclear," the fix is almost always re-saving the product's variants so Storely can re-resolve the mapping, not a problem with the chart itself.