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.
