Wishlist
Let customers save products for later with a built-in wishlist engine that’s fully integrated with Mercur’s product and pricing stack. Mercur’s Wishlist module allows authenticated customers to bookmark products they’re interested in and come back to them later - without needing to rebuild wishlist logic in every storefront. Wishlists are customer-specific, aware of product variants and pricing, and ready to plug into your UX and marketing flows.
How you manage wishlists in Mercur
Give customers a simple “save for later” flow, while your team gets clean, structured data on what people actually want to buy.
With the Wishlist module, you can:
- Let customers save products to their personal wishlist from any storefront built on Mercur.
- Keep one wishlist per customer, with all saved products attached to that customer’s profile.
- Store relationships between customers and products in a dedicated wishlist domain, not ad-hoc tables.
- Fetch wishlists along with product details and variant pricing, using Mercur’s pricing engine under the hood.
- Expose wishlists via API to storefronts, apps, and marketing tools (for back-in-stock flows, reminders, etc.).
- Ensure wishlists are secure & customer-specific by tying entries to authenticated users only.
.png)
Build custom marketplace with Mercur
Create your unique multi-vendor platform with our powerful, flexible marketplace solution that adapts to your business needs.
What the Wishlist module delivers for your business
Better customer experience & conversion
Customers don’t have to “remember” what they liked - they can save products, compare them, and come back when they’re ready to purchase.
Signal of real purchase intent
Wishlists give you a high-quality dataset of products that customers plan to buy later, not just items they briefly clicked.
Deeper personalization & remarketing
Use wishlist data to power personalized recommendations, remarketing campaigns, and “don’t forget these items” emails.
Clean integration with product & pricing
Because wishlists are built on top of Mercur’s product and pricing stack, you can always display up-to-date product details and current prices - no custom glue code required.
Core capabilities
1. Product wishlists
Give customers a native way to save items:
- Customers can add products to their wishlist directly from product pages, listings, or other touchpoints.
- Wishlists store references to actual products and variants, not just raw IDs floating around.
- The same wishlist can be reused across multiple storefronts or devices, as long as the customer is authenticated.
You design the “Add to wishlist” UX; Mercur provides the backend behavior.
2. Customer-specific wishlists
Each customer gets their own personal wishlist container:
- One wishlist per customer (by default), attached to their customer profile.
- The wishlist can hold multiple products, creating a clean one-to-many relationship.
- Wishlist data is filtered by authenticated user, using the customer_id from the auth context - no shared or anonymous lists by accident.
This makes wishlist data secure, predictable, and easy to reason about.
3. Wishlist data model & relationships
Structured relationships instead of ad-hoc favorites:
- Customer → Wishlist: a one-to-one relationship - each customer has their own wishlist entity.
- Wishlist → Products: a one-to-many relationship - one wishlist can contain many products.
- Entries can point to products (and, via products, to variants and their prices).
- The data model aligns with Mercur’s product and pricing domains, so you can query all the information you need in a single graph query.
This is ideal for building scalable wishlists in marketplaces or B2B2C setups.
4. Automatic price calculation for wishlist items
Always show up-to-date prices on saved items:
- When retrieving wishlist items, Mercur can automatically calculate current prices for those products and variants.
- The wishlist query can include variant price data (e.g. via wishlist.products.variants.prices.*) so frontends get everything they need at once.
- Pricing logic respects regions, currencies, and price lists, just like in normal cart/checkout flows.
This ensures customers see accurate prices on wishlist views, not stale snapshots.
5. Workflows & APIs for wishlist actions
Use workflows to plug wishlist logic into your stack:
- Use workflows such as createWishlistEntryWorkflow to create new wishlist entries in a controlled, reusable way.
- Extend or customize wishlist workflows if your business logic requires additional checks (e.g. limits, eligibility, extra metadata).
- Use the wishlist APIs to:
- add products,
- remove products,
- fetch wishlists with products and prices,
- paginate over wishlist items for customers with long lists.
- add products,
Workflows keep wishlist behavior consistent across all your frontends.
Build custom marketplace with Mercur
Schedule a guided tour of Mercur Marketplace tailored to your specific marketplace requirements. Connect with our team to discuss how we can help bring your marketplace vision to life.