{"id":3190,"date":"2026-02-27T00:42:32","date_gmt":"2026-02-27T00:42:32","guid":{"rendered":"https:\/\/www.swiftcommerce.io\/help\/?post_type=docs&#038;p=3190"},"modified":"2026-02-27T00:42:33","modified_gmt":"2026-02-27T00:42:33","password":"","slug":"wishlist","status":"publish","type":"docs","link":"https:\/\/www.swiftcommerce.io\/help\/products\/wishlist\/","title":{"rendered":"Wishlist"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Let customers save products they love and come back to buy them later \u2014 boosting engagement and conversions.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Product Wishlist feature adds a simple &#8220;Add to Wishlist&#8221; 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.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Whether you run a fashion store, electronics shop, or any WooCommerce store \u2014 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).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">All core wishlist functionality is completely free \u2014 buttons, guest support, a dedicated wishlist page, social sharing, toast notifications, and three page layout templates.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Requirements<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Swift Commerce Free 1.4.0+<\/li>\n\n\n\n<li>WooCommerce 7.0+<\/li>\n\n\n\n<li>WordPress 6.0+<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Getting Started<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Step 1: Enable the Feature<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to\u00a0<strong>WordPress Dashboard \u2192 Swift Commerce \u2192 Products <strong>\u2192<\/strong> Wishlist<\/strong><\/li>\n\n\n\n<li>Toggle the\u00a0<strong>Enable Wishlist<\/strong>\u00a0switch<\/li>\n\n\n\n<li>Click\u00a0<strong>Save Changes<\/strong><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">That&#8217;s it \u2014 a wishlist button now appears on all your product pages.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 2: Set Up Your Wishlist Page<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Swift Commerce automatically creates a wishlist page when you first enable the feature. To verify or change it:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to the\u00a0<strong>Page &amp; Sharing<\/strong>\u00a0tab<\/li>\n\n\n\n<li>Under\u00a0<strong>Wishlist Page<\/strong>, select the page that contains the wishlist<\/li>\n\n\n\n<li>The page should contain the shortcode\u00a0<code>[SWIFT_COMMERCE_wishlist]<\/code><\/li>\n<\/ol>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong>&nbsp;If the page wasn&#8217;t auto-created, create a new page, add the shortcode&nbsp;<code>[SWIFT_COMMERCE_wishlist]<\/code>, publish it, and select it in settings.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Settings Reference<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">General Settings<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><strong>Enable Wishlist<\/strong><\/td><td>Master on\/off toggle for the entire feature<\/td><td>Off<\/td><\/tr><tr><td><strong>Allow Guest Wishlists<\/strong><\/td><td>Let non-logged-in visitors save wishlists via a 30-day cookie<\/td><td>On<\/td><\/tr><tr><td><strong>Remove After Adding to Cart<\/strong><\/td><td>Automatically remove a product from the wishlist when added to cart<\/td><td>Off<\/td><\/tr><tr><td><strong>Redirect to Wishlist<\/strong>&nbsp;<em>(Pro)<\/em><\/td><td>Redirect customers to the wishlist page after adding a product<\/td><td>Off<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Button Settings<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><strong>Display Style<\/strong><\/td><td>How the button looks \u2014 Icon + Text, Icon Only, or Text Only<\/td><td>Icon + Text<\/td><\/tr><tr><td><strong>Icon<\/strong><\/td><td>Heart, Star, or Bookmark<\/td><td>Heart<\/td><\/tr><tr><td><strong>Add Text<\/strong><\/td><td>Button label when product is not in wishlist<\/td><td>&#8220;Add to Wishlist&#8221;<\/td><\/tr><tr><td><strong>Remove Text<\/strong><\/td><td>Button label when product is already in wishlist<\/td><td>&#8220;Remove from Wishlist&#8221;<\/td><\/tr><tr><td><strong>Position on Single Product<\/strong><\/td><td>Where the button appears on the product page<\/td><td>After Add to Cart<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Shop \/ Archive Grid Settings<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><strong>Show on Shop Pages<\/strong><\/td><td>Display a wishlist button overlay on product cards in shop\/archive pages<\/td><td>On<\/td><\/tr><tr><td><strong>Button Position<\/strong><\/td><td>Corner position of the overlay button \u2014 Top Left, Top Right, Bottom Left, Bottom Right, or After Add to Cart<\/td><td>Top Right<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Notification Toast Settings<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><strong>Show Notification<\/strong><\/td><td>Display a popup notification when adding\/removing products<\/td><td>On<\/td><\/tr><tr><td><strong>Position<\/strong><\/td><td>Where the toast appears \u2014 Top Left, Top Center, Top Right, Bottom Left, Bottom Center, Bottom Right<\/td><td>Bottom Right<\/td><\/tr><tr><td><strong>Duration<\/strong><\/td><td>How long the toast stays visible (in milliseconds)<\/td><td>3000<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Page &amp; Sharing Settings<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><strong>Wishlist Page<\/strong><\/td><td>The WordPress page that displays the wishlist<\/td><td>Auto-created<\/td><\/tr><tr><td><strong>Social Sharing<\/strong><\/td><td>Which share buttons to show on the wishlist page<\/td><td>Facebook, Twitter\/X, Pinterest, Email<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Available share options: Facebook, Twitter\/X, Pinterest, Email, WhatsApp, and Copy Link.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Navigation Menu<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Setting<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><strong>Add to Menu<\/strong><\/td><td>Automatically add a &#8220;Wishlist&#8221; link to a navigation menu<\/td><td>Off<\/td><\/tr><tr><td><strong>Menu Location<\/strong><\/td><td>Which theme menu location to add the link to<\/td><td>Primary<\/td><\/tr><tr><td><strong>Show Item Count<\/strong><\/td><td>Display a badge with the number of wishlisted items<\/td><td>On<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Appearance &amp; Templates<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Wishlist Page Templates<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Three pre-built page templates are available to all users:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Template<\/th><th>Best For<\/th><\/tr><\/thead><tbody><tr><td><strong>Classic Table<\/strong><\/td><td>Traditional stores \u2014 shows all details in a clean table layout with image, price, stock status, date added, and action buttons<\/td><\/tr><tr><td><strong>Modern Cards<\/strong><\/td><td>Visual stores \u2014 displays products as a card grid with large images and streamlined info<\/td><\/tr><tr><td><strong>Minimal List<\/strong><\/td><td>Quick browsing \u2014 compact rows focused on product name, price, and action buttons<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Select your template in&nbsp;<strong>Appearance \u2192 Wishlist Page Preview<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Color Customization<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">All users can customize colors for:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Button Colors<\/strong>\u00a0\u2014 Background, text, and border colors for both default and &#8220;in wishlist&#8221; states<\/li>\n\n\n\n<li><strong>Grid Overlay Colors<\/strong>\u00a0\u2014 Background, icon, and active-state colors<\/li>\n\n\n\n<li><strong>Toast Colors<\/strong>\u00a0\u2014 Background and text colors<\/li>\n\n\n\n<li><strong>Page Colors<\/strong>\u00a0\u2014 Table borders, header background, Add to Cart button, and Remove button colors<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">For full customization control including typography, spacing, borders, and more, upgrade to Swift Commerce Pro.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Shortcodes<\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;SWIFT_COMMERCE_wishlist]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Renders the full wishlist page \u2014 product table, empty state, and social sharing buttons.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Usage:<\/strong>&nbsp;Add to any WordPress page.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;SWIFT_COMMERCE_wishlist_button]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Renders a wishlist add\/remove button for a specific product.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Attributes:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Attribute<\/th><th>Description<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><code>product_id<\/code><\/td><td>The WooCommerce product ID<\/td><td>Current product (if on a product page)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Example:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;SWIFT_COMMERCE_wishlist_button product_id=\"123\"]<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong>&nbsp;Use this shortcode when you set the button position to &#8220;Custom&#8221; or want to place the button in page builders, custom templates, or widgets.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">How It Works<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">For Logged-In Customers<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Wishlist data is stored in your WordPress database, tied to the user&#8217;s account. Items persist across devices and sessions \u2014 your customer can add items on their phone and view them on desktop.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">For Guest Visitors<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When&nbsp;<strong>Allow Guest Wishlists<\/strong>&nbsp;is enabled, a 30-day session cookie tracks their wishlist. If the visitor later creates an account, their guest wishlist items are preserved.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Wishlist Page<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The wishlist page displays:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Product image<\/strong>\u00a0(linked to the product)<\/li>\n\n\n\n<li><strong>Product name<\/strong>\u00a0(linked to the product)<\/li>\n\n\n\n<li><strong>Price<\/strong>\u00a0(current WooCommerce price)<\/li>\n\n\n\n<li><strong>Stock status<\/strong>\u00a0(In Stock \/ Out of Stock badge)<\/li>\n\n\n\n<li><strong>Date added<\/strong><\/li>\n\n\n\n<li><strong>Add to Cart<\/strong>\u00a0button (disabled for out-of-stock items)<\/li>\n\n\n\n<li><strong>Remove<\/strong>\u00a0button<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">When the wishlist is empty, customers see a friendly message with a&nbsp;<strong>Browse Products<\/strong>&nbsp;button linking to your shop.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Social Sharing<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Below the wishlist table, customers can share their wishlist via the platforms you&#8217;ve enabled (Facebook, Twitter\/X, Pinterest, Email, WhatsApp, or Copy Link). Sharing uses the wishlist page URL \u2014 no personal data is sent to third parties.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Let customers save products they love and come back to buy them later \u2014 boosting engagement and conversions. Overview The Product Wishlist feature adds a simple &#8220;Add to Wishlist&#8221; 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 [&hellip;]<\/p>\n","protected":false},"author":101,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_category":[72],"doc_tag":[],"class_list":["post-3190","docs","type-docs","status-publish","hentry","doc_category-products"],"year_month":"2026-09","word_count":884,"total_views":"110","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Mansoor Ahmad","author_nicename":"helpadmin","author_url":"https:\/\/www.swiftcommerce.io\/help\/author\/helpadmin\/"},"doc_category_info":[{"term_name":"Products","term_url":"https:\/\/www.swiftcommerce.io\/help\/docs-category\/products\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/docs\/3190","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/users\/101"}],"replies":[{"embeddable":true,"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/comments?post=3190"}],"version-history":[{"count":1,"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/docs\/3190\/revisions"}],"predecessor-version":[{"id":3191,"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/docs\/3190\/revisions\/3191"}],"wp:attachment":[{"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/media?parent=3190"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/doc_category?post=3190"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.swiftcommerce.io\/help\/wp-json\/wp\/v2\/doc_tag?post=3190"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}