Documentation

Get Started With ZS Wishlist

Install the app, turn on the wishlist button, and start collecting saves. Most stores are live in under five minutes.

🚀 Installation

Installing ZS Wishlist is quick and easy. Simply install the app from the Shopify App Store—no coding or developer assistance is required.

1
install-app.png


📥 Install the App

Click Install and approve the installation for your store.

2
open-the-dashboard.png


📊 Open the Dashboard

After installation, you'll be redirected to the ZS Wishlist Dashboard, where you can view saved items, top-performing products, and recent customer activity.

3
setup.png


⚙️ Complete the Setup

Follow the in-app setup wizard, or use the instructions below to enable the wishlist button on your storefront.

🎨 Theme setup

Adding ZS Wishlist to your storefront takes just a few minutes. The app uses Shopify app blocks and app embeds, so it works with Online Store 2.0 themes — nearly every current theme — without editing theme code.

  1. 🛍️ Open the Theme Editor: From your Shopify Admin, go to Online Store → Themes → Customize.

    Open-the-theme-editor.png

  2. ⚡ Enable App Embeds: Open the App embeds panel and turn on:
    • ❤️ Wishlist Header Icon
    • 🛒 Wishlist on Cards
    enable-app-embeds.png

  3. ➕ Add the Wishlist Button: Open a Product template, click Add block, and select Wishlist Button. Place it near the Add to cart button for the best shopping experience.

    add-the-wishlist-button.png

  4. 💾 Save Your Changes: Click Save to publish the changes to your storefront.

    save-your-changes.png

💡 Pro Tip: Position the wishlist button next to the Add to cart button. It's one of the first places shoppers look, helping increase engagement and wishlist saves.

🧡 Wishlist page

Give your shoppers a dedicated space to view all their saved products. The Wishlist Page helps improve engagement and makes it easy for customers to return to their favorite items.

  1. 📝 Create a Wishlist Page: Go to Online Store → Pages → Add page, then title it Wishlist.

    create-a-wishlist-page.png

  2. 🎨 Add the Wishlist Block: In the Theme Editor, open the Wishlist page template, then add the Wishlist Page block.

    add-the-wishlist-block1.png

    add-the-wishlist-block2.png

  3. 🔗 Connect the Page Link: The Wishlist Header Icon is usually connected automatically. If it is not linked, go to the Wishlist Header Icon settings and select your Wishlist page or enter the page URL: /pages/wishlist.
  4. 🛒 Access Wishlist Features: Once the Wishlist setup is complete, shoppers can use the header icon to open their wishlist, view saved items, add products to their cart, or remove items.

    access-wishlist-features.png

🎨 Customize the Wishlist Button

Customize the wishlist button to match your store’s style from the app’s Settings page. Changes will appear instantly in the live preview.

customize-the-wishlist-button.png

Available customization options:

Button Appearance


  • Button Text — Change the label shown on the button, such as “Add to Wishlist” or “Save for Later”.
  • Icon — Choose your preferred icon, such as a heart, star, or bookmark.
  • Button Style — Select a style that fits your store: solid, outline, or text-only.
  • Button Color — Set a custom color using a hex code to match your brand.
  • Custom SVG Icon - Replace the default icon with your own SVG icon.
  • Icon & Button Styling -Adjust the icon size, stroke thickness, button spacing, border radius, background color, border visibility, and saved state color to match your store’s design.

Product Page Placement


  • Button Placement —Choose where the wishlist button appears: next to the Add to Cart button, below the product price, or on the product image.

Product Card Button


  • Icon & Appearance - Choose the icon style (Heart, Star, or Bookmark), customize the icon color, add a custom SVG icon, and adjust the icon size.
  • Button Layout & Style - Control the button size, padding, border radius, background color, and border visibility.
  • Position - Choose where the wishlist button appears on the product card, such as the top right corner.
  • Saved State Colors - Customize the icon and background colors when a product has been added to the wishlist.

👤 Guest Wishlists

Allow shoppers to save items to their wishlist without logging in. Guest wishlists are stored securely in the browser and linked to an anonymous identifier.

guest-wishlists1.png

When a guest shopper later logs in, their saved items are automatically merged into their customer account, so nothing is lost. You can enable or disable guest wishlists anytime from the app’s Settings page based on your store’s requirements.

guest-wishlists2.png

Guest wishlists help you capture shoppers who are not ready to create an account yet, allowing them to save products and return when they are ready to purchase.

👥 Customers

Track shoppers who have saved products to their wishlist. This page displays customers who have added at least one product to their wishlist, along with their wishlist activity.

customers.png

The dashboard shows the number of customers with wishlists, the percentage of your total customer base, and the total number of Shopify customers.

You can search customers by email or customer ID to quickly find specific wishlist users.

If no customers are shown, it means no shoppers have used the wishlist feature yet. Customers will automatically appear here once they save products to their wishlist.

✉️ Email Reminders

Bring shoppers back to your store by sending them personalized emails about the products they have saved. Email reminders are available on the Starter plan and above.

email-reminders.png

Reminder types

  • Price drop — Notify shoppers when the price of a saved item decreases.
  • Back in stock — Let shoppers know when a previously unavailable saved item becomes available again.
  • Low stock — Tell shoppers a saved item is nearly sold out. You set the threshold. Professional plan.
  • Saved Item Reminder — Send a gentle reminder after a selected number of days to encourage shoppers to revisit their saved products.

Design Your Emails

Create beautiful reminder emails using the built-in template editor. Customize your emails by adding headings, text, product lists, buttons, and more using the drag-and-drop blocks. For advanced customization, switch to code mode and edit the HTML directly.

Personalize emails using dynamic variables to display shopper and product information automatically.

Every reminder email includes a one-click unsubscribe link to help you stay compliant with email regulations.

🔔 Notify Me Button

When a shopper lands on a sold-out product, a Notify me when available button appears under the wishlist button. They leave their email (signed-in customers just tap), and the app emails them when the product is back. Available on the Starter plan and above.

  1. Make sure the Wishlist Button block is on your product template (see Theme setup).
  2. In the app, open Reminders and switch on Email reminders with Back in stock enabled.
  3. Open Settings, switch on “Notify me” on sold-out products and click Save.
  4. Open a sold-out product on your store to see the button.

The button follows the selected variant. If size M is sold out and size L is not, it only shows while M is selected.

🗂️ Multiple Wishlists

Let shoppers sort what they save into their own named lists — “Birthday”, “Summer”, “For the flat”. Available on the Starter plan and above.

  1. Open Settings and switch on Multiple wishlists, then Save.
  2. On the storefront wishlist page a lists bar appears. Shoppers click New list, give it a name, and use the Move to… menu on any item.

Deleting a list never deletes the products in it — they go back to the main wishlist. Lists work for guests as well as signed-in customers.

🔗 Sharing & Quick View

Wishlist sharing

Shoppers can send their wishlist to a friend with a link, or post it to social apps. The link opens a read-only copy; nothing about the owner is shown. Switch on Wishlist sharing in Settings. Professional plan.

Quick view

On the wishlist page, shoppers can open any saved product in a pop-up and add it to the cart without leaving the list. It is on for every plan and needs no setup.

🌍 Languages & Wording

The wishlist follows the language of your storefront automatically. It comes translated into 12 languages: English, German, French, Italian, Spanish, Japanese, Polish, Dutch, Portuguese (Brazil), Portuguese (Portugal), Swedish and Danish. This is included on every plan.

The app’s admin screens are available in English, German, Spanish, French, Italian, Japanese and Polish, and follow the language of your Shopify admin.

Change any phrase

  1. Open Settings and scroll to Storefront text.
  2. Click Edit wording and pick the language.
  3. Type your own wording next to any phrase. Leave a field empty to keep ours.
  4. Click Save. The storefront updates straight away.

Add a language we don’t ship

In the same card, type the language code your store uses — for example tr, ko or zh-CN — and write each phrase yourself.

Some phrases contain a placeholder such as {count}. Keep it in your wording — it is replaced by the real number on the storefront.

📊 Analytics & Export

Understand what your shoppers are interested in with detailed wishlist insights. The Analytics page helps you track your most wishlisted products, daily save trends, and the number of guest versus logged-in shoppers.

analytics.png

Export wishlist data as a CSV file from the Export page for further analysis, reporting, or retargeting campaigns.

export.png

Full analytics and export features are available on the Starter plan and above.

Save-to-purchase tracking

On the Professional plan, the Analytics page can show how many saved products were later bought and the revenue from them. Click Allow order access on the Analytics page once; the app then matches new orders against wishlists every day.

📨 Klaviyo

Send wishlist activity to Klaviyo as events on each shopper’s profile, so you can build flows and segments from them. Professional plan.

  1. In Klaviyo, go to Settings → API keys → Create private API key with full access to Events and Profiles.
  2. In the app, open Settings, find the Klaviyo card and paste the key into Private API key.
  3. Click Save. The key is checked right away and the card shows Connected.

Events sent:

  • Added to Wishlist — a shopper saved a product.
  • Requested Back in Stock Alert — a shopper tapped Notify me.
  • Wishlist Price Drop — a saved product got cheaper.
  • Wishlist Back in Stock — a saved product is available again.
  • Wishlist Low Stock — a saved product is nearly sold out.

Events are only sent for shoppers whose email is known (signed-in customers and guests who left an email).

⚡ Shopify Flow

Start your own automations from wishlist activity. Professional plan.

  1. Open Settings, switch on Shopify Flow triggers and Save.
  2. In Shopify Flow, create a workflow and choose one of the ZS Wishlist triggers: Product saved to wishlist or Back-in-stock alert requested.
  3. Add your actions — tag the customer, send an internal email, add to a list — and turn the workflow on.

Flow triggers fire for signed-in customers.

🏷️ Customer Tags

Tag wishlist users in Shopify so you can build a customer segment and email, discount or advertise to them. Professional plan.

  1. Open Settings, switch on Tag wishlist customers and Save.
  2. Click Allow customer tagging and approve the one extra permission.
  • zs-wishlist — the customer saved a product.
  • zs-wishlist-notify — the customer asked for a back-in-stock alert.

In Shopify, go to Customers → Segments and filter by either tag.

🔌 Webhooks

Send every wishlist event as a JSON POST to Zapier, Make, Omnisend automations or your own system. Professional plan.

  1. Open Settings, find the Webhook card and paste a public https:// address.
  2. Click Save, then Send a test event to check your receiver answers.

Each request carries two headers: x-zs-wishlist-event (the event name) and x-zs-wishlist-signature (an HMAC-SHA256 signature of the body, made with the signing secret shown in the card) so you can verify it really came from the app.

🎯 Ad Pixels

When a shopper saves a product, the app sends an AddToWishlist event to the Meta, Google Analytics 4 and TikTok pixels already installed on your store. There is nothing to set up, and nothing is sent if a pixel is not installed. Use the event to build retargeting audiences in your ad tool.

💳 Plans & Billing

Start for free and upgrade whenever you need more features. All billing is securely handled through Shopify and will appear on your regular Shopify invoice.

plans.png

  • Free Plan — Includes unlimited wishlist saves, guest and customer wishlists, quick view, button customization, 12 storefront languages, editable wording, and the top products report.
  • Starter Plan — $4.99/month — Includes everything in the Free plan, plus email reminders, the Notify me button, multiple wishlists, discount codes in reminders, full analytics, and CSV export.
  • Professional Plan — $14.99/month — Includes everything in the Starter plan, plus wishlist sharing, low-stock alerts, save-to-purchase tracking, Klaviyo, Shopify Flow, customer tags, webhooks, and custom CSS.

All paid plans include a 14-day free trial. You can upgrade, change, or cancel your plan anytime from the app’s Plans page.

💬 FAQ

Does it work with my theme?

It works with Online Store 2.0 themes — nearly every current theme — through app blocks and app embeds, with no theme code editing. On older “vintage” themes the header icon and card hearts work, but the product-page button block cannot be added.

Is the free plan really free?

Yes. The Free plan has no time limit and no hidden fees. Unlimited saves, guest and customer wishlists, and button customization are all included.

What happens to a guest's wishlist when they log in?

It merges automatically into their customer account. Items they saved as a guest carry over the moment they log in — nothing is lost.

How are reminder emails sent?

Reminders are sent automatically when a saved item drops in price or returns to stock. Every email includes an unsubscribe link, and shoppers who opt out never receive another.

Can I cancel anytime?

Yes. Change or cancel your plan anytime from the Plans page. Billing is prorated through Shopify.