Install on Shopify

Embeds

Stashlist works through five theme app embeds and one wishlist page block. The embeds are toggled on in the theme editor and inject themselves into your theme automatically. No code required.

Turning on the embeds

All five embeds are enabled in the same place — the App Embeds panel in your theme editor.

  1. Go to Online Store → Themes → Customize in your Shopify admin.
  2. Click the App embeds icon in the left sidebar (it looks like a puzzle piece).
  3. Find the Stashlist embeds and toggle on the ones you want. Click Save.
Start with Stashlist Settings. This embed must be on for the others to work. It controls global settings like icon style, variant mode, and toast notifications.

Wishlist PDP Inject

Injects a heart icon onto your product pages. Customers click it to save or unsave the current product. Toggle this on in App Embeds — no block placement needed.

Wishlist Collection

Overlays a heart icon on each product card in your collection grids. Customers can save products without leaving the collection page. Toggle on in App Embeds.

Note: Icon placement varies slightly by theme. If the icons overlap other elements (like a Quick Add button), adjust the badge container selector in the Stashlist Settings embed.

Wishlist Cart

Adds a "Save for later" action to cart line items, letting customers move products from their cart to their wishlist instead of removing them. Toggle on in App Embeds.

Adds a floating wishlist icon link to your header so customers can access their wishlist from any page. Toggle on in App Embeds.

Wishlist Page

The wishlist page shows customers all their saved items with add to cart, remove, and share actions. Unlike the embeds above, this is added as a block on a Shopify page.

How to set it up

  1. In your Shopify admin, go to Online Store → Pages and create a new page. Name it Wishlist — the URL will be /pages/wishlist.
  2. In the theme editor, navigate to that page (Pages → Wishlist).
  3. Click Add section and select Stashlist Wishlist Page. Click Save.
  4. Add a link to /pages/wishlist in your navigation menu via Online Store → Navigation so customers can find it.
Next Klaviyo Integration → Fire wishlist events to Klaviyo flows and segments Back Introduction → Overview and quick start