Sillage Widget

Bring AI-powered scent discovery into any perfume store.

The Sillage Widget helps shoppers find the right fragrance from a retailer's own catalog, then gives merchants attribution events to connect discovery to purchase.

Try the playgroundStart integrating

Tiny embed

A lightweight loader mounts the widget without blocking your storefront.

Retailer catalog

Recommend products the shopper can buy from your inventory.

Conversion proof

Track product clicks, email capture, and purchase completion.

Get your API key

Sillage provisions widget keys during retailer onboarding. You receive a test key beginning with sw_test_, a live key beginning with sw_live_, and the allowed storefront origins for each key.

Onboarding checklist

  1. 1. Share your storefront domainsInclude production, staging, and localhost domains that should be allowed.
  2. 2. Receive test and live keysKeep live keys scoped to trusted production origins.
  3. 3. Validate the widgetUse the playground and verify endpoint before launch.
  4. 4. Connect conversion eventsAdd purchase tracking on your order confirmation page.

How the widget chooses products

In production, most stores use a connected catalog: Sillage recommends from the products already linked to your widget API key. You can also pass page products directly when you want a landing page, seasonal edit, or quick demo to recommend from a small hand-picked set.

Connected catalog

Best for live stores. Your API key points the widget to the products Sillage already knows are available in your inventory.

Page products

Best for demos and special pages. Your page sends a product list during initialization, and the widget recommends only from that list.

Five-minute quick start

Add the loader script, create a container element, and initialize the widget with your key. The loader queues calls until the full widget bundle is ready.

Minimal embed

html

<div id="sillage-widget"></div>
<script
  src="https://mysillage.co/widget/v1/sillage-widget.js"
  async
  onload="SillageWidget.init({
    containerId: 'sillage-widget',
    apiKey: 'sw_test_your_key',
    locale: 'en',
    theme: 'auto'
  })"
></script>