Platforms

BigCommerce Virtual Try-On Integration

Open SaaS APIs plus Tryonixs SDK for mid-market beauty catalogs.

BigCommerce Virtual Try-On Integration — Tryonixs virtual try-on preview

BigCommerce + Tryonixs

  • BigCommerce suits mid-market beauty brands needing open SaaS APIs without Shopify lock-in
  • Tryonixs script manager injection or custom widget template on product pages
  • Variant metafields via third-party field apps or custom fields API

Virtual try-on on BigCommerce

BigCommerce suits mid-market beauty brands needing open SaaS APIs without Shopify lock-in

Tryonixs script manager injection or custom widget template on product pages

Variant metafields via third-party field apps or custom fields API

Channel manager listings can link to parent site try-on experience

Setup guide

Installation

  • Create Tryonixs API account and store hash credentials
  • Add script to Script Manager footer on product pages
  • Map custom fields tryon_asset per SKU via CSV import
  • Place widget template below add-to-cart in stencil theme

SDK setup

  • Listen to BC product option change events
  • Initialize with product.sku from stencil JSON context
  • Stencil CLI theme deploy to sandbox first

API

  • Products v3 catalog update for custom fields
  • Webhooks on product.updated

Authentication

  • OAuth for app; storefront uses signed embed key

Webhooks

  • Order created hook optional for tryon attribution

Performance

Limit simultaneous GLB loads on variant matrix pages

Use BigCommerce CDN for fallback thumbnails

Analytics

Segment integration via analytics.addShippingInfo pattern

Try-on events to Google Analytics 4

Troubleshooting

Stencil cache: hard refresh theme version

SKU case sensitivity in asset map

CSP on headless BigCommerce composable frontends

Best practices

Use custom fields not description HTML for asset IDs

B2B edition: enable try-on only on retail channel

Coordinate with Amazon channel to avoid asset drift

BigCommerce FAQ

Catalyst headless?
Embed NPM SDK in Next.js storefront with catalog API custom fields.
Multi-storefront?
Separate script manager per storefront with unique API keys.
Maybelline-scale SKUs?
Bulk custom field import via Products API batch.
Free Tryonixs tier?
Starter plan supported on all BigCommerce plans.
Contact us