# 1. Description

The **Advanced Wishlists** plugin replaces Shopware's native wishlist with a fully-featured wishlist solution. Customers can create multiple named wishlists, share them publicly via link, add items directly to the cart, and receive email notifications when prices drop.

![Admin overview of all customer wishlists](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-870fb8aa31c885c24d9624a326d30944b1b86629%2F4.png?alt=media)

## What the Plugin Does

* **Multiple named wishlists** — Customers create as many lists as they need with custom names (e.g. "Birthday", "Christmas", "Home Office") and manage them from their account.
* **Public sharing via link** — A wishlist can be set to "Public". The generated share link can be shared via WhatsApp, email, or a copy-link button. Visitors can browse the list and save it as their own.
* **Guest wishlist** — Logged-out visitors can save products to a local wishlist stored in localStorage. When they register or log in, their guest items are automatically merged into their first wishlist. The feature is GDPR-compliant and respects cookie consent.
* **Heart icon toggle** — A heart icon appears on product cards, product detail pages, and cart line items. Clicking it opens a dropdown for selecting a target wishlist. Clicking an already-selected list removes the product.
* **Per-item quantity** — Each wishlist item has its own quantity field. When adding to the cart, the wishlist quantity is used.
* **Save cart as wishlist** — A single click saves all cart items (excluding promotions) to a new or existing wishlist.
* **CSV export and import** — Customers and merchants can export wishlists as CSV and import products by product number.
* **Add by product number** — On the wishlist detail page, customers can add products directly by entering a product number (SKU).
* **Price-drop notifications** — Customers can opt in to email notifications per wishlist. When a product's price drops below its price at the time it was added (minus a configurable threshold), a notification is sent via Shopware's Flow Builder.
* **Global wishlists** — Merchants create curated wishlists in the admin (e.g. "Staff Picks"), which appear below customers' own lists on the wishlist overview page.
* **Admin analytics** — Under **Customers → Wishlists → Analytics** you'll find the most-wishlisted products, activity trends, and conversion rates.
* **Unavailable products** — Inactive or channel-removed products are displayed in a dedicated section on the detail page. Alternative products can be assigned in the admin.

## Relationship to Shopware's Native Wishlist

The plugin operates **independently alongside** Shopware's native wishlist. It does not disable it automatically. To use only the plugin, disable the native wishlist under **Settings → Shop → Cart → Enable wishlist**. Existing native wishlists can be migrated using the console command `momo:wishlists:migrate-native` (see [Installation](https://docs.momocode.de/en/shopware-6/advanced-wishlists/2.-installation)).

## Technical Requirements

* Shopware 6.6 (tested from 6.6.0)
* PHP 8.2+
* Shopware Scheduled Task Worker must be active (for price-drop notifications)
* No external services or dependencies