Choose the layer you need
The product release, installable SDK and hosted fitting room are separate layers. “SDK 2.0” names the product release; it does not instruct developers to install version 2 of the Web SDK. These guides target @spreeai/web-sdk@3.0.0.
| Layer | Purpose | Version or controls |
|---|---|---|
| SDK 2.0 | Product capabilities: try-on views, comparison, styling and fit. | Product release name |
| Web SDK | Authenticate and embed the hosted experience on your storefront. | npm package v3.0.0 |
| Hosted fitting room | SPREEAI-managed shopper experience loaded by the integration. | Managed independently; confirm approved capabilities |
| Shopify App | Catalog connection, product enablement, feature switches and theme blocks. | App settings and published theme |
Capability map
| Capability | Shopify path | Web SDK path |
|---|---|---|
| Additional views | Back, Three-quarter and Side switches in Feature Settings. | No corresponding per-view flag in the released render options. Confirm hosted availability with SPREEAI. |
| Compare | Feature switch plus Compare block or Fitting Room shortcut. | No public Compare button method in the returned SDK. Confirm the custom integration path. |
| Build a look | Feature switch and Fitting Room shortcut; merchant outfits are managed separately. | Pass multiple garments to request a matching available outfit. This is distinct from a dedicated Build a look launcher. |
| Size-aware fit | Independent feature switch and Find your size block. | enableSizingRecommendation requests sizing inside try-on. Confirm supported product data and account availability. |
| Size / price display | Managed by the app experience. | showSizes, showPrices and per-garment display data. |
Choose a starting point
Custom web
Web quickstart
Install the package and render your first eligible garment.
Managed storeShopify setup
Follow the app’s own onboarding, feature and block controls.
MobileNative integrations
Use the iOS or Android guide for the approved mobile package.
CompatibilityVersions explained
Keep release naming, package versions and managed builds separate.