Diagnose the symptom
| Symptom | Check | Next action |
|---|---|---|
| init returns null | Issued clientId, approved environment, authentication response. | Keep the standard product journey available; inspect console / network errors without sharing tokens. |
| No Web SDK button | Container exists; garment belongs to your partner; garment and pinned variant are available. | Verify the garment mapping and validation message. |
| Outfit opens one garment | An available matching outfit must contain all requested garments and pinned variants. | Verify the outfit; first-garment fallback is expected on no match. |
| Sizes show but no recommendation | showSizes and enableSizingRecommendation are separate options. | Confirm sizing is requested and supported for the product / account. |
| Shopify block missing | Ready and enabled product, active feature, correct saved block and published template. | Check all three controls, subscription and Billing notices. |
| Shopify view or shortcut missing | Feature switch and corresponding block setting; Virtual Try-On dependency where applicable. | Reload after changing Feature Settings. |
| Cart fails | Your cart endpoint response, ID / variant mapping and validation. | Report the error, clear loading state and leave a retry path. |
| New dialog layout breaks page | Old .try-on-dialog overrides and narrow-screen behavior. | Re-check against the v3 layout. |
Send a useful support report
- Integration path, SDK package version and environment.
- Affected product / garment ID and selected variant.
- Browser, operating system and device, plus timestamp and timezone.
- Exact reproduction steps, expected result and observed result.
- A sanitized console / network error or correlation ID where available.
Use your onboarding support channel or support@spreeai.com. Never include client secrets, access tokens or customer imagery in a general support report.