# 4. 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](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-75503fbee1d3053043a644287776d3349866efea%2F1.png?alt=media)

## 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 heart 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 and the visitor has given cookie consent for "Functional" cookies, 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.

> **Note:** The heart icon in the header and on product cards is only displayed after the visitor has accepted the optional cookies and subsequently reloaded or navigated to a new page.

## 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](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-04787c062617bc2e53e8d866dc63ad208e1fcbe0%2F2.png?alt=media)

### 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](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-901878e6bbf9dc8b6ed899c54919704bb8feb947%2F3.png?alt=media)

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.