Configuration

Shortlist is configured from one screen: the Shortlist menu in wp-admin. It opens with sensible defaults — install and the wishlist works. The settings group into the master switch, guest access, placements, button labels, the list appearance and the dedicated wishlist page. Every option carries a ? help popover.

Enable wishlist

The master switch. When off, Shortlist renders nothing on the storefront. Turn it on to show the wishlist button in your chosen placements.

Allow guests

On by default. When on, logged-out visitors get a wishlist kept in a cookie, which merges into their account automatically the next time they log in. Turn it off to send logged-out clickers to the login screen instead.

Placements

Choose where the Add to wishlist button appears, each toggled independently:

• Shop and archive loops — on each product card.
• Single product page — after the product summary.
• My Account tab — adds a Wishlist tab to the WooCommerce My Account area.

You can also show an optional saved-item count next to the My Account menu label, which updates live as the shopper toggles items.

Button labels

• Add label — text for the button when the product is not on the list.
• Remove label — text when it is already saved.
• Variation hint — message shown on a variable product until the shopper picks options, since the button saves a specific variation.

Wishlist list appearance

These control how the saved list renders on the My Account tab, the dedicated page and the shortcode/block:

• Heading and intro text above the list.
• Empty-list message when nothing is saved.
• Column count for the grid.
• Product details — which columns appear: image, name, price, add-to-cart and the remove button, each toggled independently.

Dedicated wishlist page

You can give the wishlist its own page rather than relying only on the My Account tab:

• Choose a page from the dropdown, or click Create wishlist page to publish one containing the [shortlist] shortcode.
• Show list on page — when on, Shortlist outputs the grid automatically if the page body has no [shortlist] shortcode yet. If the page already contains the shortcode, leave this off to avoid a duplicate list.

How saves are stored

Logged-in customers’ lists are stored in a custom table keyed to their user ID. Guest lists live in an HttpOnly cookie (shortlist_session, six-month lifetime) and transfer into the account on login — no manual import. Deleting the plugin removes the wishlist table and its options.

Engine and theming

The wishlist orchestration — guest cookie, ownership, AJAX toggle, My Account endpoint, guest-to-customer transfer, asset enqueue and markup hooks — is provided by the shared wppoland/storefront-kit Wishlist engine; Shortlist is a thin adapter for text domain, options, asset URLs, templates and custom-table storage. The storefront styles are themeable (heart icon, dark mode, CLS-safe grid), so you can adjust them from your theme stylesheet.