🧺 Supporting Multiple Wishlists

The Wishlist Plugin supports multiple wishlists per customer out of the box. This enables richer customer experiences and advanced personalization features.

---

💡 Why Use Multiple Wishlists?

Here are a few common use cases:

• 🛒 "Buy Later" list — A wishlist for items the customer is thinking about
• 🎁 Gift registry — For weddings, birthdays, or other events
• 🧢 Style collections — Curated items by category (e.g. "Winter Gear", "Sneakers", "Accessories")
• 👀 Private vs Public — One wishlist for sharing, another for personal planning

---

⚙️ Creating Multiple Wishlists

To create a wishlist, simply call the POST /store/wishlists endpoint multiple times.

You can store multiple wishlist IDs per customer and show a selector/dropdown in the UI.

Using SDK

const createdWishlist = await sdk.alphabite.wishlist.create({
  sales_channel_id: "sc_...",
  name: "Optional name", // optional
});

Using REST (Medusa SDK or fetch)

import { CreateWishlistInput, CreateWishlistOutput } from "@alphabite/medusa-sdk";

const createdWishlist = await sdk.client.fetch<CreateWishlistOutput>(`/store/wishlists`, {
  method: "POST",
  body: {
    sales_channel_id: "sc_...",
    name: "Optional name", // optional
  } as CreateWishlistInput,
});

API Reference

Learn more about our Medusa SDK Wrapper Alphabite Medusa SDK Wrapper 🔗

You can view the full endpoint documentation for Create a Wishlist 🔗

---

📋 Listing Wishlists

To show the user all their saved wishlists:

Using SDK

const retrievedWishlist = await sdk.alphabite.wishlist.list({});

Using REST (Medusa SDK or fetch)

import { RetrieveWishlistInput, RetrieveWishlistsOutput } from "@alphabite/medusa-sdk";

const retrievedWishlist = await sdk.client.fetch<RetrieveWishlistsOutput>(`/store/wishlists`, {
  method: "GET",
  query: {} as RetrieveWishlistsInput,
});

API Reference

Learn more about our Medusa SDK Wrapper Alphabite Medusa SDK Wrapper 🔗

You can view the full endpoint documentation for List Wishlists 🔗

➕ Adding Items to a Specific Wishlist

Every addItem operation requires a wishlist ID.

Using SDK

const addedWishlistItem = await sdk.alphabite.wishlist.addItem({
  id: "wl_...",
  product_variant_id: "variant_...",
});

Using REST (Medusa SDK or fetch)

import { AddItemToWishlistInput, AddItemToWishlistOutput } from "@alphabite/medusa-sdk";

const addedWishlistItem = await sdk.client.fetch<AddItemToWishlistOutput>("/store/wishlists/:wishlist_id/items", {
  method: "POST",
  body: {
    id: "wl_...",
    product_variant_id: "variant_...",
  } as AddItemToWishlistInput,
});

This lets users add products to specific lists from dropdowns or modal selectors.

API Reference

Learn more about our Medusa SDK Wrapper Alphabite Medusa SDK Wrapper 🔗

You can view the full endpoint documentation for Add Item to Wishlist 🔗

---

🔄 Renaming or Updating

You can rename any wishlist using:

Using SDK

const updatedWishlist = await sdk.alphabite.wishlist.update({
  id: "wl_...",
  name: "New Name", // optional
});

Using REST (Medusa SDK or fetch)

import { UpdateWishlistInput, UpdateWishlistsOutput } from "@alphabite/medusa-sdk";

const updatedWishlist = await sdk.client.fetch<UpdateWishlistsOutput>(`/store/wishlists/${wishlistId}`, {
  method: "PUT",
  body: {
    name: "New Name", // optional
  } as UpdateWishlistsInput,
});

API Reference

Learn more about our Medusa SDK Wrapper Alphabite Medusa SDK Wrapper 🔗

You can view the full endpoint documentation for Update a Wishlist 🔗

---

🔢 Total Items Across All Wishlists

To power a UI counter (like a wishlist badge in the header), call the total-items-count endpoint.

Using SDK

const updatedWishlist = await sdk.alphabite.wishlist.totalItemsCount({
  id: "wl_...", // optional, to get count for a specific wishlist, omit for all wishlists items count
});

Using REST (Medusa SDK or fetch)

import { TotalItemsCountInput, TotalItemsCountsOutput } from "@alphabite/medusa-sdk";

const { totalItemsCount } = await sdk.client.fetch<TotalItemsCountsOutput>(`/store/wishlists/total-items-count`, {
  method: "PUT",
  body: {
    id: "wl_...", // optional, to get count for a specific wishlist, omit for all wishlists items count
  } as TotalItemsCountsInput,
});

This works with both guest and customer wishlists.

💡 If you support multiple wishlists, this is the preferred way to get an accurate item count.

---

🔗 Related

• Create Wishlist
• List Wishlists
• Add Item
• Total Items Count

---