What is Wishlist Save Education?
Wishlist Save Education is a feature that gently encourages first-time shoppers to use your store's wishlist. When a visitor browses your store and hasn't saved anything to their wishlist yet, the system shows a series of subtle, non-intrusive nudges that teach them how to use the wishlist button. The goal is to drive that crucial first wishlist save, which increases engagement and return visits.
This feature works automatically on Collection pages and Product Detail Pages (PDP) that use the Advanced Wishlist button layout (Storefront Layout).
How It Works
Wishlist Save Education only activates for shoppers who have an empty wishlist in the current browsing session. The moment a shopper saves any item to their wishlist, all education nudges stop immediately for the rest of that session.
There are three types of nudges your shoppers may see:
1. Toast Notification - A slim banner that slides in with a message like "Interesting? Click the ♥ to save it to your wishlist." It uses the same clean, neutral styling (white background, dark text) as your existing "added to wishlist" notification, so it feels native to the experience. A progress bar shows how long it will remain visible. On Product pages, a scroll-triggered toast also includes a "Wishlist Now" call-to-action button.
2. Tooltip - A small speech-bubble popup that appears directly above the wishlist button, pointing at it with an arrow. It carries the same educational message and auto-dismisses after 30 seconds. Shoppers can also close it manually with the ✕ button.
3. Button Text Transition - On product pages, the wishlist button text temporarily changes to an engaging phrase like "Price drops? Know first." or "Almost gone. Just saying." for 15 seconds before reverting to the original label. This only applies to buttons that display text (icon+text or text-only styles).
Where Nudges Appear
On Collection Pages, shoppers see an alternating pattern of toast and tooltip nudges, up to 3 rounds (6 total impressions across visits within the same session). The toast on collection pages does not include a clickable call-to-action - it simply educates.
On Product Detail Pages, shoppers see an alternating pattern of tooltip and button-text transition nudges, also up to 3 rounds. In addition, there is a separate scroll-triggered toast: if the shopper has been on the page for at least 5 seconds and scrolls past 70% of the page, a toast appears with a "Wishlist Now" button that lets them save the product directly. This scroll toast only fires once per session, and when it appears, any other visible nudge (tooltip or button text change) is dismissed first to avoid clutter.
Trigger Conditions - Nudges only begin once the wishlist button is visible in the shopper's viewport and they have spent more than 10 seconds on the page. This ensures the nudges don't fire immediately on page load and only appear when the shopper is actively browsing.
Session Behavior
Education nudges are session-scoped. The system tracks how many nudges a shopper has seen within their current browser session. Once the session ends (e.g., closing the browser tab), the counters reset. This means a returning visitor who still has an empty wishlist will see another round of nudges on their next visit - giving them another chance to discover the feature.
If a shopper performs any wishlist action (saving a product, clicking the toast CTA, etc.), all education stops immediately for the remainder of that session.
Enabling and Disabling
Wishlist Save Education is enabled by default for all stores using the Storefront Layout. No setup is required - it works out of the box once you have Advanced Wishlist buttons on your Collection and Product pages.
If you need to disable this feature, you can do so by setting the educationLayerEnabled metafield to false in your Swym Wishlist app metafields (app.metafields.swym_wishlist.educationLayerEnabled). Contact Swym support if you need assistance updating this setting.
Supported Languages
Education nudge messages are available in the following languages: English, German, French, Japanese, and Turkish. The text automatically adapts to your store's active locale. The messages are designed to feel conversational and encouraging - for example, button transition text includes phrases like "Yours when ready." and "Price drops? Know first."
Frequently Asked Questions
Will the education toast conflict with the "Added to wishlist" success notification? No. The education nudge and the success notification cannot appear at the same time. Education only shows when the wishlist is empty, and the moment a shopper adds an item, the education toast is dismissed before the success notification appears. Both also use the same notification component, so one naturally replaces the other.
Can I customize the nudge messages? The messages are defined in your theme's locale files under the education key. If you need to adjust the wording, you can edit the corresponding locale JSON files in the Swym Wishlist theme extension. Or reach out to [email protected]
Does this affect store performance? No. The education layer uses lightweight JavaScript with efficient viewport detection (IntersectionObserver) and throttled scroll/resize handlers. It adds no extra network requests and only activates for shoppers with empty wishlists.
What if my wishlist button only shows an icon (no text)? The button text transition nudge only applies to buttons that display text (icon+text or text-only). If your button is icon-only, shoppers will still see toast and tooltip nudges - the button text transition is simply skipped.
Does this work with AJAX/SPA themes? The feature is designed for standard page navigation. If your theme uses single-page-app style navigation (e.g., AJAX page transitions without full reloads), the education layer may not reinitialize between page transitions. Contact Swym support if you experience issues with SPA-style themes.