Overview - Swish Docs

The Swish SDK is available on the storefront as window.swish after initialization.

const swish = window.swish;

// Or wait for it
document.addEventListener("swish-ready", () => {
  const swish = window.swish;
});

API reference

Options for createSwish() - design tokens, features, components, and intents.

Trigger actions like saving a product, opening a list, or starting a checkout.

Reactive signals for tracking saved item state, context, and counts.

Drop-in swish-save and swish-drawer custom elements for Liquid themes.

Insert Swish buttons into your theme using DOM observation.

Subscribe to item, list, cart, and notification events.

Query and mutate saved items, lists, orders, and notifications.

Load products, images, and recommendations from the Shopify Storefront API.

Clipboard, share URLs, and programmatic UI element creation.

Save button, header badge, custom wishlist page, and drawer tabs - as elements, state helpers, and React.