The Mage Loyalty app embed must be enabled on your live Shopify theme before the Wishlist will work on your storefront. If you have not done this yet, see: How to Enable the Mage Loyalty App Embed.
What is the Wishlist?
The Wishlist lets customers save products they want to come back to later. They can add items from any product or collection page, group them into custom collections (for example "Birthday gifts" or "Living room ideas"), and move items into the cart in one click.
The Wishlist is available on the Starter plan and above.
Customers can also share a collection with friends or family by sending them a link.
Logged-out shoppers (guests) can only save items once you switch on Allow guest wishlists under Wishlist → Settings. It is off by default.
When a guest signs in, their saved items move into their account, as long as the account's wishlist is still empty.
How to Enable the Wishlist
From your Shopify admin, open the Mage Loyalty app.
In the left menu, click Wishlist.
Click Customise to open the wishlist builder.
At the top of the builder, toggle Wishlist on.
Click Save.
How to Add a Wishlist Link to Your Storefront
The wishlist popup opens any time a customer clicks a link ending in #mage-wishlist.
Most stores add a small heart icon to the navbar so customers can open their wishlist from any page. To set this up:
Decide where you want the trigger. Most stores use a heart icon in the main navbar, next to the cart and account icons.
Edit the link in your store's navigation menu (or theme code) to point to #mage-wishlist. For example: https://your-store.com/#mage-wishlist
Save your changes.
Open your storefront and click the heart to test - the wishlist popup should open.
If you also use the Mage Account Sidebar, you can add a Wishlist block to allow wishlisted items to appear here. This could be used in combination with the wishlist popup, or as a replacement if you prefer.
Customising the Wishlist
The wishlist builder has four tabs:
Tab | What It Controls |
General | Dialog title and the labels you use for "collection" |
Pages | Text for each state of the popup: home, logged-out, and inside a collection |
Design | Colours, border radius, and button styling |
Advanced | Custom CSS, z-index, and the disable customizer styles toggle |
Guest Wishlists
A guest wishlist lets logged-out shoppers save items. When they log in or sign up later, their saved items are added to their account, as long as the account's wishlist is still empty. If the account already has saved items, the guest items are not carried over.
Guest wishlists are off by default. While they are off, a logged-out shopper who tries to save an item is asked to sign in.
Enabling guest wishlists
In the Mage Loyalty app, go to Wishlist → Settings.
Tick Allow guest wishlists.
Click Save.
What guests can and cannot do
Guests can save and remove items and open their wishlist.
Guests cannot create collections or share them. Both need an account.
Guests do not get the reminder, back-in-stock or price-drop alerts you set up under Wishlist → Alerts & Emails.
A guest's wishlist is tied to the browser they saved it in.
Customising the guest sign-in prompt
Once guest wishlists are enabled, a locked "Guest sign-in prompt" block appears in the wishlist builder. To customise it:
Open the wishlist builder and go to the Pages tab.
Select Home, then open the Layout section.
Expand the Guest sign-in prompt block to edit the following options:
Setting | What it does |
Position | Show the prompt at the top or bottom of the wishlist. |
Status label | Short message shown next to the guest indicator (e.g. "Browsing as a guest"). |
Sign in label | Text on the sign-in link (e.g. "Sign in"). |
Sign in URL | Where the sign-in link points to (e.g. |
Create account label | Text on the create-account link (e.g. "Create account"). |
Create account URL | Where the create-account link points to (e.g. |
Click Save when you're done.
Product Button Action
Each item in the wishlist has an action button. To choose what it does, go to Wishlist → Settings and set Product button action in the Wishlist settings card:
Option | What it does |
Add to cart | Adds the product straight to the cart. This is the default. You can edit the Add to cart button label and the Added state button label. |
View product | Links to the product page instead. You can edit the View product button label. |
The choice applies to the wishlist popup and to the Wishlist block in the Account Sidebar. Saved for Later has its own Product button action, in the Saved for later settings card on the same page, so the two can differ.
The Add all to cart button depends on this setting. It can only be switched on, and is only shown to shoppers, while the action is Add to cart. The same applies to Saved for Later.
Home Page Options
These options are in the wishlist builder, on the Pages tab under Home:
Setting | What it does |
Enable "Add all to cart" button | In the Behaviour section. Off by default. When on, shoppers can add every available item to the cart in one click. Only offered while Product button action is Add to cart. |
Low stock threshold | In the Behaviour section. Shows an "Only N left" badge on an item when its stock is at or below this number. The default is 5. Set it to 0 to hide the badge. |
Popular wishlisted items | An optional block. In the Layout section, click Add and choose Popular wishlisted items to show a carousel of the products shoppers wishlist most. Expand the block to set its Heading, the Number of products (4 to 8) and Show wishlist count on each card. |
Sharing a Collection
Customers share one collection at a time. Inside a collection, the Share button gives them a link to copy and send. The wishlist as a whole cannot be shared, only a collection.
The customer must be logged in to share, because collections need an account. Anyone with the link can view the shared collection, without logging in.
Sharing is always on. There is no setting to switch it off.
To change the wording in the wishlist popup, open the wishlist builder, go to the Pages tab and select Collection. The fields are Share button, Share description, Copy button and Copied state.
Common Mistakes to Avoid
Enabling the Wishlist before the app embed is active. The Wishlist will not appear on your storefront until the Mage Loyalty app embed is enabled on your live theme. Always complete the app embed step first.
Not clicking Save after toggling the Wishlist on. The toggle alone does not save the change. Click Save before leaving the builder.
Forgetting to add the trigger link. Customers can save items with the hearts you add to your theme, but they will not be able to view their saved items until you add a link or icon pointing to #mage-wishlist.
Troubleshooting
The hearts are not appearing on my product pages
The wishlist hearts must be added independently to enabling the wishlist. Refer to our separate documentation on how to setup the wishlist heart on your product cards.
Confirm the Mage Loyalty app embed is enabled on your current live theme. This is the most common cause. See: How to Enable the Mage Loyalty App Embed.
Check that you clicked Save after enabling the Wishlist toggle.
Open your storefront in an incognito browser window to rule out caching.
Clicking my heart icon does not open the popup
Confirm the link ends in #mage-wishlist and is spelled correctly.
Check that the Wishlist toggle is on inside the Mage app.