Embed Widget — Developer Docs

Add wishlisting to your store in 5 minutes

One script tag. Any website. Let your customers save products directly to their WishlistCart wishlists — driving return visits and purchases.

yourstore.com/products/some-product
Save to Wishlist
W

The floating button appears on every product page

Quick start

From zero to embedded in three steps.

01

Create a free API key

Sign in and go to Dashboard → Embed Widget. Create a widget and copy your API key — it's shown once.

02

Add the script tag

Paste a single <script> tag into your page. No build step, no dependencies, no framework required.

03

Done — your customers can now save products

A floating button appears on your site. Visitors click it, sign in to WishlistCart, and save the current page to their wishlist.

Step 2 — paste this into your HTML:

<script
  src="https://wishlistcart.com/widget.js"
  data-key="wlc_your_api_key_here"
></script>

That's it. No npm install, no build step, no configuration required to get started.

How it works for your visitors

Minimal friction. Maximum delight.

Visitor sees the floating button

A discreet "W" button appears in the corner of your page. It never covers your own UI.

They click — a popup opens

A lightweight popover opens showing their WishlistCart wishlists. No page navigation, no redirects.

Item saved to their wishlist

The current product is added instantly. They can come back via their wishlist when ready to buy.

API reference

Two endpoints. CORS-enabled. No extra auth headers needed — the key is in the URL.

GET/api/widget/{apiKey}/wishlists

Returns all public wishlists owned by the widget creator.

Auth

API key in URL path

Response

{ wishlists: [{ id, name, slug, _count }] }
POST/api/widget/{apiKey}/add-item

Adds an item to a specific public wishlist.

Auth

API key in URL path

Response

{ success: true, item: { id, title } }

Request body

{ wishlistId, title, url?, price?, currency?, imageUrl?, quantity? }

Optional — configure before loading:

// Place this BEFORE the <script> tag
window.WishlistCartWidget = {
  apiKey: 'wlc_your_api_key_here',
  buttonText: 'Save to Wishlist',
  position: 'bottom-right', // or 'bottom-left'
}

Pricing

The widget is free for all WishlistCart accounts — no paid plan required.

Free

for all plans, forever

  • Up to 5 widgets per account
  • Unlimited requests
  • CORS-enabled API
  • Domain allowlist
  • API key rotation
Get started free

Frequently asked questions

Is the widget free?

Yes, completely free for all WishlistCart accounts. No paid plan required.

Which websites is it compatible with?

Any website that can add a <script> tag: Shopify, WordPress, Webflow, custom HTML, and more. If you can paste a script tag, you can embed the widget.

Can I customize the button style?

You can configure the button position (bottom-left or bottom-right) and button text via the window.WishlistCartWidget config object before loading the script.

Ready to add wishlisting to your store?

Free to set up. No credit card. Works on any site that can run a script tag.

Get Your API Key