> For the complete documentation index, see [llms.txt](https://docs.momocode.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.momocode.de/en/shopware-6/advanced-wishlists/5.-storefront-usage.md).

# 5. Storefront Usage

## Wishlist Overview

Customers access their wishlists via **My Account → My Wishlists** or via the heart icon in the storefront header. The overview page shows:

* All personal wishlists with name, item count, and visibility (public/private)
* Action buttons for renaming and deleting a list
* A **Create new wishlist** button
* Below (if configured): the merchant's global wishlists as "Shop recommendations"

![My Wishlists overview page](/files/urVwV7rmxTEWwqqJgJpB)

## Creating a New Wishlist

1. On the overview page, click **Create new wishlist**.
2. Enter a name and confirm.

Alternatively, when adding a product via the heart icon dropdown, select **Create new list** — the wishlist is created on the fly.

## Adding Products to a Wishlist

> The displayed icon and the label "Wishlist" can be customised in the [Configuration](/en/shopware-6/advanced-wishlists/3.-configuration.md) — for example, a star instead of a heart, or "Order list" instead of "Wishlist".

The icon appears on:

* Product cards in listings and search results
* The product detail page
* Cart line items (cart page, checkout, order confirmation)

Clicking the heart icon opens a dropdown listing all available wishlists. Products already on a list are marked with a checkmark. Clicking a checked list **removes** the product (toggle behavior). At the bottom of the dropdown is the **Create new list** option.

### Guest Visitors

If the guest wishlist is enabled in the plugin settings, products can be saved without logging in. The data is stored in the browser's localStorage. When the guest logs in or registers, their items are automatically merged into their first wishlist.

Whether consent is required for this is determined by the **Consent source** setting:

* **Shopware cookie banner** (default), **Foreign cookie (consent-management tool)** and **Custom (JavaScript API)** — nothing is stored until consent has been granted. With the default, that consent comes from Shopware's cookie banner, category "Functional".
* **No consent check** — no consent gate applies: the guest wishlist is active without any check and the control is usable immediately. There is also no consent state in this mode, so there is nothing that could be granted or withdrawn — the two paragraphs below do not apply.

When a consent check is active, the wishlist icon appears in the header and on product cards **immediately** once the visitor grants consent — no reload or navigation required. If they withdraw consent, the consent cookie and the stored guest wishlist are deleted right away and the header counter resets to zero.

> **Note:** While a consent check is active and no consent is present, the wishlist control is hidden by default. You can instead configure it to stay visible and ask for consent when clicked. With **No consent check** this setting has no effect, since the control is always usable anyway. For which of the four sources applies and how to connect an external consent management tool, see [Consent & Consent Tools](/en/shopware-6/advanced-wishlists/4.-consent.md).

## Wishlist Detail Page

The wishlist detail page provides the following features:

### Managing Items

* **Change quantity** — Each item has +/− buttons and a quantity field. Changes are saved automatically via AJAX.
* **Add to cart** — Per-item button; the off-canvas cart opens automatically.
* **Add all to cart** — Adds all items (with their individual quantities) to the cart in one action.
* **Multi-select** — Select items via checkboxes and add them to the cart together.
* **Remove item** — Removes the item from the wishlist (no cart action).

### Add by Product Number

Below the item list is a collapsible **Add by product number** section. Enter a product number (SKU) and optionally a quantity. The product is immediately added to the wishlist if found.

### Unavailable Products

If the corresponding option is enabled in the configuration, a dedicated section for inactive or channel-removed products appears above the regular item list. Customers can:

* Remove the unavailable item directly from the wishlist.
* Add a merchant-assigned alternative product to the wishlist with a single click.

![Wishlist detail page with items and quantities](/files/gMhm7tuAhMhtoc0PKO8L)

### CSV Export and Import

* **Export as CSV** — Downloads the current wishlist as a CSV file (columns: product number, name, quantity, date added).
* **Import from CSV** — Opens a file selection dialog. The CSV file must contain at least a column with product numbers. Items not found and duplicates are skipped and listed in a summary.

### Price-Drop Notifications

The detail page includes (when globally enabled) a **Price-drop notifications** toggle. Customers can turn this on or off per wishlist independently. When active, they receive an email when any item on this wishlist drops in price.

## Sharing a Wishlist

1. On the detail page, click **Make public**. The visibility changes to "Public".
2. A share link section appears with buttons for WhatsApp, Email, and **Copy link**.
3. Share the link. Recipients can browse the wishlist without logging in.

Click **Make private** to block access immediately (the link becomes invalid, but the token is preserved in case the list is made public again later).

### Public Wishlist for Recipients

Share link recipients see:

* The wishlist name and owner's name
* All items as standard Shopware product cards (with image, name, variants, price, add-to-cart button)
* Share buttons (WhatsApp, Email, Copy link)
* A **Save as my wishlist** button (for logged-in customers)

![Public wishlist — recipient view](/files/Befpi1adNpNyypbl1kNr)

When saving as their own list, a new private wishlist is created with the same name, containing all items from the shared list.

## Saving the Cart as a Wishlist

On the cart page, a **Save as wishlist** button is available. A dropdown lets customers:

* Save all cart items to a new wishlist (default name: "Cart – {date}")
* Add all cart items to an existing wishlist (duplicates are skipped)

The cart is **not** cleared.