Skip to content
WPPoland Documentation

Getting started

Most shops can save the first product to a wishlist in a few minutes. Shortlist ships enabled — install, open Shortlist settings, visit the shop page.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce 8.0 or newer (HPOS and Cart/Checkout Blocks supported)
  • PHP 8.1 or newer

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Shortlist from the plugin directory (when live on WordPress.org) or upload the shortlist folder to /wp-content/plugins/.
  3. Activate the plugin. Shortlist creates its wishlist table on activation.

First configuration

Section titled “First configuration”

Open Shortlist in wp-admin:

  • Enable wishlist — master switch.
  • Allow guests — on by default; off sends logged-out clickers to login.
  • Placements — shop loop, single product page, My Account tab; optional item count next to the menu label.
  • Button labels — add/remove text and variation hint for variable products.
  • List appearance — columns, which product fields show, empty-list message, intro text.
  • Dedicated wishlist page — choose a page from the dropdown or click Create wishlist page (published page with [shortlist]). Enable Show list on page to auto-output the grid when the page body is still empty.

Each row has ? help — use it when you are deciding placements or copy.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open Shop — click Add to wishlist on a simple product; button should toggle and announce via aria-live.
  2. Open a variable product — button stays disabled with a hint until you pick options; then save the variation.
  3. Open My Account → Wishlist (logged in) or your dedicated page — saved items should appear.
  4. Log out (if guests allowed), save another product, log back in — lists should merge.

Shortcode and block

Section titled “Shortcode and block”
[shortlist]

Use the Shortlist block in the block editor for the same output. If the dedicated page already contains [shortlist], turn off auto-inject to avoid duplicate lists.

Guest cookies

Section titled “Guest cookies”

Guest lists use a HttpOnly cookie (shortlist_session, six-month lifetime). Merging runs on login — no manual import step for shoppers.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers one wishlist, guests, variations, My Account, dedicated page, shortcode/block and AJAX sync.

Shortlist PRO (planned) adds multiple named lists, share links, price-drop/back-in-stock alerts and analytics — not basic wishlist access.

Need help?

Section titled “Need help?”