Installation

Install once, customize per store.

Choose the snippet that matches your storefront stack. Each example loads the small Sillage loader first, then mounts the full widget when it is ready.

Plain HTML

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>

These minimal embeds use the connected catalog by default: the widget recommends from the products linked to your API key. Pass page products only when a specific page should use its own hand-picked product list.

Content Security Policy

If your storefront uses CSP, allow the Sillage script and API origin. Keep the exact production host in your policy instead of allowing every domain.

Subresource integrity

The widget is versioned under /widget/v1/. Pinning an SRI hash is optional for v1 because retailers receive controlled versioned assets; if you require SRI, generate the hash from the exact production bundle and rotate it when upgrading.