In this guide
Explore the steps and reference sections below.
On this page
Let customers save products they love and come back to buy them later — boosting engagement and conversions.
Overview
The Product Wishlist feature adds a simple “Add to Wishlist” button to your product pages and shop archives, letting customers bookmark products for later. Wishlists are stored in your database for logged-in users and via cookies for guests, so nothing is lost between visits.
Whether you run a fashion store, electronics shop, or any WooCommerce store — wishlists give your customers a reason to come back. They can share wishlists with friends, get notified when prices drop (Pro), and you get insight into what your customers want most (Pro).
All core wishlist functionality is completely free — buttons, guest support, a dedicated wishlist page, social sharing, toast notifications, and three page layout templates.
Requirements
- Swift Commerce Free 1.4.0+
- WooCommerce 7.0+
- WordPress 6.0+
Getting Started
Step 1: Enable the Feature
- Navigate to WordPress Dashboard → Swift Commerce → Products → Wishlist
- Toggle the Enable Wishlist switch
- Click Save Changes
That’s it — a wishlist button now appears on all your product pages.
Step 2: Set Up Your Wishlist Page
Swift Commerce automatically creates a wishlist page when you first enable the feature. To verify or change it:
- Go to the Page & Sharing tab
- Under Wishlist Page, select the page that contains the wishlist
- The page should contain the shortcode
[SWIFT_COMMERCE_wishlist]
Tip: If the page wasn’t auto-created, create a new page, add the shortcode
[SWIFT_COMMERCE_wishlist], publish it, and select it in settings.
Settings Reference
General Settings
| Setting | Description | Default |
|---|---|---|
| Enable Wishlist | Master on/off toggle for the entire feature | Off |
| Allow Guest Wishlists | Let non-logged-in visitors save wishlists via a 30-day cookie | On |
| Remove After Adding to Cart | Automatically remove a product from the wishlist when added to cart | Off |
| Redirect to Wishlist (Pro) | Redirect customers to the wishlist page after adding a product | Off |
Button Settings
| Setting | Description | Default |
|---|---|---|
| Display Style | How the button looks — Icon + Text, Icon Only, or Text Only | Icon + Text |
| Icon | Heart, Star, or Bookmark | Heart |
| Add Text | Button label when product is not in wishlist | “Add to Wishlist” |
| Remove Text | Button label when product is already in wishlist | “Remove from Wishlist” |
| Position on Single Product | Where the button appears on the product page | After Add to Cart |
Shop / Archive Grid Settings
| Setting | Description | Default |
|---|---|---|
| Show on Shop Pages | Display a wishlist button overlay on product cards in shop/archive pages | On |
| Button Position | Corner position of the overlay button — Top Left, Top Right, Bottom Left, Bottom Right, or After Add to Cart | Top Right |
Notification Toast Settings
| Setting | Description | Default |
|---|---|---|
| Show Notification | Display a popup notification when adding/removing products | On |
| Position | Where the toast appears — Top Left, Top Center, Top Right, Bottom Left, Bottom Center, Bottom Right | Bottom Right |
| Duration | How long the toast stays visible (in milliseconds) | 3000 |
Page & Sharing Settings
| Setting | Description | Default |
|---|---|---|
| Wishlist Page | The WordPress page that displays the wishlist | Auto-created |
| Social Sharing | Which share buttons to show on the wishlist page | Facebook, Twitter/X, Pinterest, Email |
Available share options: Facebook, Twitter/X, Pinterest, Email, WhatsApp, and Copy Link.
Navigation Menu
| Setting | Description | Default |
|---|---|---|
| Add to Menu | Automatically add a “Wishlist” link to a navigation menu | Off |
| Menu Location | Which theme menu location to add the link to | Primary |
| Show Item Count | Display a badge with the number of wishlisted items | On |
Appearance & Templates
Wishlist Page Templates
Three pre-built page templates are available to all users:
| Template | Best For |
|---|---|
| Classic Table | Traditional stores — shows all details in a clean table layout with image, price, stock status, date added, and action buttons |
| Modern Cards | Visual stores — displays products as a card grid with large images and streamlined info |
| Minimal List | Quick browsing — compact rows focused on product name, price, and action buttons |
Select your template in Appearance → Wishlist Page Preview.
Color Customization
All users can customize colors for:
- Button Colors — Background, text, and border colors for both default and “in wishlist” states
- Grid Overlay Colors — Background, icon, and active-state colors
- Toast Colors — Background and text colors
- Page Colors — Table borders, header background, Add to Cart button, and Remove button colors
For full customization control including typography, spacing, borders, and more, upgrade to Swift Commerce Pro.
Shortcodes
[SWIFT_COMMERCE_wishlist]Renders the full wishlist page — product table, empty state, and social sharing buttons.
Usage: Add to any WordPress page.
[SWIFT_COMMERCE_wishlist_button]Renders a wishlist add/remove button for a specific product.
Attributes:
| Attribute | Description | Default |
|---|---|---|
product_id | The WooCommerce product ID | Current product (if on a product page) |
Example:
[SWIFT_COMMERCE_wishlist_button product_id="123"]Tip: Use this shortcode when you set the button position to “Custom” or want to place the button in page builders, custom templates, or widgets.
How It Works
For Logged-In Customers
Wishlist data is stored in your WordPress database, tied to the user’s account. Items persist across devices and sessions — your customer can add items on their phone and view them on desktop.
For Guest Visitors
When Allow Guest Wishlists is enabled, a 30-day session cookie tracks their wishlist. If the visitor later creates an account, their guest wishlist items are preserved.
Wishlist Page
The wishlist page displays:
- Product image (linked to the product)
- Product name (linked to the product)
- Price (current WooCommerce price)
- Stock status (In Stock / Out of Stock badge)
- Date added
- Add to Cart button (disabled for out-of-stock items)
- Remove button
When the wishlist is empty, customers see a friendly message with a Browse Products button linking to your shop.
Social Sharing
Below the wishlist table, customers can share their wishlist via the platforms you’ve enabled (Facebook, Twitter/X, Pinterest, Email, WhatsApp, or Copy Link). Sharing uses the wishlist page URL — no personal data is sent to third parties.
Current dashboard tabs
The dashboard groups controls under General, Appearance, and Page & Sharing. Pro also displays Emails and Analytics. Older references to a separate Button tab or Shop/Archive Grid tab belong to the Appearance controls in the current interface.
General and sharing
General lets you allow guest wishlists, remove an item after it is added to cart, and (Pro) redirect shoppers to their wishlist after saving. Pro Capabilities can enable multiple wishlists, limit each customer to 2–50 lists, and allow public/private/shared privacy choices. Page & Sharing controls the wishlist page, navigation entry, and social sharing. Test links as a guest and as a signed-in customer, especially when privacy options are enabled.
Emails (Pro)
Turn On Sale Notifications and/or Back in Stock Notification on as needed. Each has a shared email customizer for content and branding. On-sale messages are for wishlisted products that go on sale; back-in-stock messages are for wishlisted products that become available again. Send a test email and verify the actual trigger with a test product before relying on either automation.
Analytics (Pro)
The Analytics tab reports wishlist activity, most-saved products, wishlists by registered user, recent activity, and new wishlists over time. Refresh or adjust the period if a report is empty; a load error is not a zero count.
Storefront validation
- Save a product from a product page and a shop/archive card. Confirm the correct button and notification toast appear.
- Open the wishlist page as a guest and as a customer, then add an item to the cart. Check the remove-after-add rule.
- For multiple lists and privacy options, test creation, sharing, and access from a separate browser session.