Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

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. On its first run after activation, Shortlist creates the {prefix}shortlist_items table, seeds the default settings into the shortlist_settings option, and flushes rewrite rules once so the My Account shortlist endpoint resolves without a manual permalink save.

If WooCommerce is missing or inactive, Shortlist registers nothing and shows an admin notice instead.

First configuration

Section titled “First configuration”

Open Shortlist in wp-admin (the menu uses the manage_woocommerce capability, so shop managers reach it, not only administrators):

  • 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]

The shortcode takes no attributes, it always renders the current visitor’s own list. Use the Shortlist Wishlist block in the block editor for the same server-rendered output, so the editor preview matches the front end. 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?”