# Wysh
> Full documentation content for Wysh
---
# Default
## Getting started
### Getting Started Overview
**URL:** https://wysh.mantledocs.com/overview
In this area, you’ll find guidance on how to install and configure Wysh for use.
---
### Install Wysh on your store
**URL:** https://wysh.mantledocs.com/install-wysh-on-shopify
## Install Wysh with the setup wizard
Wysh setup is now completed in the setup wizard inside the app. The wizard walks you through choosing a theme, selecting default or custom settings, and enabling Wysh in your theme editor.
This guide explains the new storefront setup flow for Shopify merchants. It focuses on installing Wysh on your online store.
Theme choices made in the setup wizard are app-level settings. Theme editor block settings are theme-level settings. By default, if you set custom styling or placement in the wizard, those wizard settings override styling set through theme blocks.
## Before you start
- You need access to your Shopify admin.
- You need permission to manage apps and edit your online store theme.
- Make sure you know which theme you want to install Wysh on. You can choose your live theme or a draft theme in the wizard.
## Install Wysh
Install Wysh in Shopify, then open the app from your Shopify admin.
In Wysh, click the button to start the installation wizard.
The wizard shows all themes in your store.
Select the theme where you want Wysh to be installed. You can choose:
- Your **live theme** if you want to set up Wysh on the storefront customers currently see.
- A **draft theme** if you want to test setup before publishing changes.
If you are making design changes first, choose a draft theme so you can review everything before publishing it live.
Next, choose **Default settings** or **Custom settings**. You can choose only one option in the wizard.
### Default settings
If you choose default settings, Wysh uses:
- A default black and white colour scheme
- Standard styling
- A floating wishlist badge instead of a header icon
### Custom settings
If you choose custom settings, you can set:
- Icon colours across different areas of the storefront
- Whether the wishlist icon is **floating** or placed in the **header**
- Where the wishlist icon appears on collection pages
Wizard customisation is **app-level**. Theme editor block settings are **theme-level**. If you set custom styling or placement in the setup wizard, those wizard settings always override styling set through theme blocks unless you later enable **Override Wizard Settings** in the embed section.
When the wizard prompts you to embed Wysh, click the button to open your theme editor.
In the theme editor:
1. Open the **App embeds** area.
2. Turn on the **Wysh** embed.
3. Save your changes.
This enables Wysh on the theme you selected in the wizard.
### Override Wizard Settings
The Wysh embed includes an **Override Wizard Settings** option.
If this option is enabled, theme settings in the theme editor take precedence over wizard settings. Use this when you want to stop using wizard styling and switch to theme-level settings instead.
**Default behavior:** wizard settings win over theme block settings. **When Override Wizard Settings is enabled:** theme editor settings win over wizard settings.
## App-level vs theme-level settings
Wysh has two places where styling and placement can be controlled:
- **Setup wizard**: app-level settings that apply from inside Wysh
- **Theme editor**: theme-level settings that apply inside a specific Shopify theme
This matters when you update colours, icon placement, or display options.
Wizard settings apply when you choose custom settings during setup. These are app-level settings and, by default, they override styling or placement set through theme blocks.
Theme editor settings apply at the theme level. If you want those settings to control the storefront instead of the wizard, enable **Override Wizard Settings** in the Wysh embed.
Use the setup wizard if you want a guided setup with central app settings. Use theme-level settings if you want to control styling directly inside a specific Shopify theme.
## Partially supported themes
Some themes are only partially supported. If your theme is partially supported, you still need to use manual placement to finish setup.
Follow the manual placement guide here: [Manual theme icon placement](/getting-started/manual-theme-icon-placement).
Even if the wizard is completed, a partially supported theme may still require manual placement so the wishlist icon appears in the right place on your storefront.
## Check that Wysh is working
After setup, confirm everything is working on the selected theme:
- The Wysh embed is turned on in the theme editor
- The wishlist icon appears in the location you expected
- Your colours and styling match your chosen wizard or theme settings
- Collection page icon placement matches your selected setup options
If you installed Wysh on a draft theme, preview that theme before publishing it live.
## Troubleshooting
Check the following:
- Make sure you completed the setup wizard in Wysh.
- Confirm you selected the correct theme in the wizard.
- Open the theme editor and make sure the **Wysh** app embed is turned on.
- Save the theme editor after enabling the embed.
- If you are working on a draft theme, preview that draft theme rather than the live theme.
- If your theme is partially supported, complete manual placement using [Manual theme icon placement](/getting-started/manual-theme-icon-placement).
This usually happens because wizard settings are overriding theme-level settings.
By default, if you chose custom styling or placement in the setup wizard, those wizard settings take precedence over theme block settings.
To use theme editor settings instead:
1. Open your theme editor.
2. Open the Wysh embed settings.
3. Enable **Override Wizard Settings**.
4. Save your changes.
After that, theme-level settings should apply instead of the wizard settings.
If your theme is partially supported, the wizard may not place the wishlist icon in the correct location by itself.
You still need to manually place the icon in your theme. Follow the guide here: [Manual theme icon placement](/getting-started/manual-theme-icon-placement).
This is expected behavior for partially supported themes.
## Related guide
Use this guide if your theme is partially supported and you need to place the Wysh icon manually.
---
### Manual theme icon placement
**URL:** https://wysh.mantledocs.com/manual-theme-icon-placement
## When manual placement is needed
If your store is using an unknown or **Partially Supported** theme, Wysh may ask you to place its icons manually in your theme code. This is done during the **Theme Configuration** step in the **Setup Guide**.
Manual placement lets you choose exactly where the Wysh wishlist icon appears in your theme header, collection product cards, and product pages.
Before editing theme code, make sure you are working on the correct theme in Shopify. If possible, duplicate your theme first so you have a backup.
## Before you start
- Open **Wysh** in your Shopify admin and review the **Setup Guide**.
- Confirm whether your theme is marked **Partial Support**.
- In Shopify, go to **Online Store** > **Themes**.
- On your current theme, open the actions menu and select **Edit code**.
Some common placement examples are available in the **How It Works** page inside the Wysh app for reference.
## Header icon
Add this placeholder if you want customers to open **My Wishlist** from your store header.
In Shopify admin, go to **Online Store** > **Themes**. Open the actions menu for your theme and select **Edit code**.
In the **Sections** folder, look for `header.liquid` or a similarly named header file.
Copy and paste this code where you want the wishlist icon to appear in the header:
```html
```
If the wishlist icon doesn’t match your other header icons (size or placement), give it the same class as those icons so it picks up the same styles. You can also tweak size and related settings in the theme editor.
Click **Save** to apply the changes.
Place the header placeholder near your account, cart, or other header action icons if you want the wishlist entry point to feel natural for customers.
## Collection page icon
Add this placeholder if you want the wishlist icon to appear on collection grids or product cards, so customers can save items without opening the full product page.
In Shopify admin, go to **Online Store** > **Themes**, open the actions menu for your theme, and select **Edit code**.
Look for the file that controls product cards. Common locations include:
- `snippets/product-card.liquid`
- `snippets/card-product.liquid`
- `sections/main-collection-product-grid.liquid`
Copy and paste this code into the product card template where you want the wishlist icon to appear:
```
```
Click **Save** to apply the changes.
## Product page icon
Add this placeholder if you want the wishlist icon to appear beside the main product purchase actions, such as **Add to cart** and **Buy it now**.
In Shopify admin, go to **Online Store** > **Themes**, open the actions menu for your theme, and select **Edit code**.
Look for the file that controls the product form or product layout. Common locations include:
- `sections/main-product.liquid`
- `snippets/product-form.liquid`
- `templates/product.liquid`
Copy and paste this code where you want the wishlist icon to appear in the product template:
```
```
Click **Save** to apply the changes.
## Check that placement worked
- Open your storefront and confirm the header icon appears where you added it.
- Open a collection page and check that the wishlist icon appears on product cards.
- Open a product page and confirm the icon appears beside **Add to cart** and **Buy it now**.
- Test saving an item to make sure it is added to **My Wishlist**.
## Troubleshooting
First, make sure the code was pasted into the correct file and that you clicked **Save**. Then confirm that the **storefront embedded app** is enabled and that you completed the **Theme Configuration** step in Wysh.
Move the placeholder higher or lower in the same theme file until it appears where you want it. The exact position depends on your theme layout.
Many Shopify themes split product cards and product forms across several snippets. If the first file does not control the visible area you want, check the other common locations listed in this guide.
Open the **How It Works** page inside Wysh to review common placement examples before updating your theme code.
## Related guides
Complete app setup, including the Setup Guide, storefront embedded app, POS Smart Grid, and theme setup.
See how the product page wishlist icon works for customers once placement is complete.
---
## Features
### Send Wishlist Item Removed Event to Ometria
**URL:** https://wysh.mantledocs.com/send-wishlist-item-removed-event-to-ometria
Use this Shopify Flow template to automatically fire an event to Ometria whenever a shopper removes an item or variant from their wishlist. This workflow runs instantly behind the scenes, packaging the shopper's profile data and the specific product details into a lightweight HTTP request.
The data payload is completely pre-populated with customer and product variant variables, giving you an immediate hook to keep your Ometria customer data perfectly synchronized, clean up preference segments, or adjust active behavioral tracks when consumer tastes change.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Ometria account** with administrator privileges is required to generate API credentials.
This template relies on a custom API connection rather than a native app block. Once configured, you must coordinate with Ometria to register your custom event types and map any supplemental tracking variables before activating the flow.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/1fa09074-eeb6-41a4-a99d-ce52d7cf4c53/wysh_ometria_wishlist_item_removed.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the Wysh item removal trigger and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Ometria security token and verify your custom event endpoints before activating it.
### 1. Configure Your Ometria API Key Authorization
1. Log in to your **Ometria dashboard** and navigate to your integration/settings menu to generate a new **API Key**.
2. Open your imported workflow within **Shopify Flow** and click on the **Send HTTP request** action block.
3. Locate the **Headers** section. Look for the pre-configured header key named `X-Ometria-Auth`.
4. Paste your copied Ometria API key directly into the **Value** field next to it.
### 2. Register the Custom Event Type with Your CSM
Ometria requires custom event endpoints to be explicitly registered on your account before they will accept incoming tracking data.
- Contact your **Ometria Customer Success Manager (CSM)** and request that they create a new custom event.
- You can name this event anything you like (for example: `wishlist_item_removed`).
- Once registered, copy that exact text string, return to your Shopify Flow HTTP action block, find the payload body JSON, and update the `"event_type"` field value to match it perfectly.
### 3. Map Custom Event Properties
The template comes pre-packaged with an empty JSON `properties` block designed to let you pass supplementary data parameters over to Ometria (such as the product ID, title, or removal timestamps).
- If you choose to transmit custom properties, you **must** inform your Ometria CSM so they can configure those exact matching property data fields against the custom event on their end.
- If you do not plan to track additional properties initially, leave the pre-configured `"properties"` key as an empty object (`{}`) in the payload body code. **Do not delete the properties key entirely.**
## Turn it on
After updating your authorization headers, matching the event type string, and verifying properties, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring your storefront and streaming wishlist removal signals straight to Ometria.
Find an item saved on a test account's wishlist, remove it, and confirm inside Shopify Flow's activity log that the workflow runs and executes the HTTP request successfully.
Ensure that the event name registered by your Ometria CSM matches the "event_type" string inside the Shopify Flow JSON payload text exactly. If there is a typo or a case-sensitivity mismatch, Ometria's API pipeline will drop the data payload entirely.
## What this workflow does
Once enabled, the workflow watches for a Wysh storefront trigger indicating an item has been dropped from a collection. Shopify Flow immediately catches the event, fetches the customer’s profile email alongside the product and variant metrics, and executes an automated background HTTP POST request directly to Ometria's data pipeline. This instantly updates profile preferences in your dashboard, allowing you to maintain strict list hygiene and optimize automated retail lifecycle paths.
---
### Send Wishlist Reminder Event to Ometria
**URL:** https://wysh.mantledocs.com/send-wishlist-reminder-event-to-ometria
Use this Shopify Flow template to automatically fire an event to Ometria prompting a customer to revisit items left sitting in their saved collections. By default, this workflow features a built-in **2-day wait period** after a user builds or modifies a wishlist, checking back automatically to see if those products remain unpurchased before executing an HTTP request.
The data payload is completely pre-populated with customer and list variables, giving you an immediate hook to trigger high-conversion behavioral reminders or personalized retail engagement campaigns to nudges shoppers back toward checkout.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Ometria account** with administrator privileges is required to generate API credentials.
This template relies on a custom API connection rather than a native app block. Once configured, you must coordinate with Ometria to register your custom event types and map any supplemental tracking variables before activating the flow.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/3e051c84-c43f-4054-9452-1d8ab88a5374/wysh_ometria_wishlist_reminder.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the Wysh trigger, the time delay step, the conditional purchase verification check, and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Ometria security token and verify your custom event endpoints before activating it.
### 1. Configure Your Ometria API Key Authorization
1. Log in to your **Ometria dashboard** and navigate to your integration/settings menu to generate a new **API Key**.
2. Open your imported workflow within **Shopify Flow** and click on the **Send HTTP request** action block.
3. Locate the **Headers** section. Look for the pre-configured header key named `X-Ometria-Auth`.
4. Paste your copied Ometria API key directly into the **Value** field next to it.
### 2. Register the Custom Event Type with Your CSM
Ometria requires custom event endpoints to be explicitly registered on your account before they will accept incoming tracking data.
- Contact your **Ometria Customer Success Manager (CSM)** and request that they create a new custom event.
- You can name this event anything you like (for example: `wishlist_reminder`).
- Once registered, copy that exact text string, return to your Shopify Flow HTTP action block, find the payload body JSON, and update the `"event_type"` field value to match it perfectly.
### 3. Update Delay Intervals and Map Event Properties
- **Adjust the time delay:** The workflow is set to pause for **2 days** by default before evaluating whether to send the reminder. You can easily click into the Shopify Flow delay action block to shorten or lengthen this countdown window to match your brand's promotional cadences.
- **Map Properties:** The template comes pre-packaged with an empty JSON `properties` block designed to let you pass supplementary data parameters over to Ometria (such as list titles or product variants). If you choose to transmit custom properties, you **must** inform your Ometria CSM so they can configure those exact matching property data fields against the custom event on their end. If not, leave the pre-configured `"properties"` key as an empty object (`{}`). Do not delete the key entirely.
## Turn it on
After updating your authorization headers, setting your preferred time delay, and matching the event type string, save the workflow in Shopify Flow.
Turn the workflow on so it can begin managing countdown windows and streaming reminder triggers straight to Ometria.
For faster verification, duplicate the workflow, adjust the time delay block to 5 minutes, trigger the initial event on your storefront, and check Shopify Flow's logs to confirm the delay executes and routes the HTTP call successfully.
Ensure that the event name registered by your Ometria CSM matches the "event_type" string inside the Shopify Flow JSON payload text exactly. If there is a typo or a case-sensitivity mismatch, Ometria's API pipeline will drop the data payload entirely.
## What this workflow does
Once enabled, the workflow logs when a shopper interacts with their wishlist and pauses processing for your chosen duration (default is 2 days). When the delay window closes, the automation verifies whether the customer's items remain unpurchased. If checkout intent has stagnated, Flow packages the customer's profile metrics and pushes an automated HTTP POST payload directly to Ometria—handing your email or messaging framework a high-conversion trigger to drive shoppers back to complete their purchases.
---
### Send Wishlist Item Back in Stock Event to Ometria
**URL:** https://wysh.mantledocs.com/send-wishlist-item-back-in-stock-event-to-ometria
Use this Shopify Flow template to automatically fire an event to Ometria whenever an out-of-stock product variant is replenished on your storefront. The moment inventory levels increase, this workflow cross-references your active Wysh wishlist data to find every subscriber who has saved that exact item, executing an automated HTTP request for each matching profile.
The data payload is completely pre-populated with customer and product variant variables, giving you an immediate hook to trigger high-conversion restock notifications or cross-channel retail campaigns.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Ometria account** with administrator privileges is required to generate API credentials.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock updates.
This template relies on a custom API connection rather than a native app block. Once configured, it pairs your real-time restock events with subscriber intent data to create automated back-in-stock marketing triggers. You must coordinate with Ometria to register your custom event types and map variables before activating the flow.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/d5ef2231-f5ba-454b-9aba-4f34da7202b6/wysh_ometria_wishlist_item_back_in_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory update trigger, the stock replenishment condition check, the Wysh loop block, and the **Send HTTP request** action.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Ometria security token and verify your custom event endpoints before activating it.
### 1. Configure Your Ometria API Key Authorization
1. Log in to your **Ometria dashboard** and navigate to your integration/settings menu to generate a new **API Key**.
2. Open your imported workflow within **Shopify Flow** and click on the **Send HTTP request** action block located inside the loop block.
3. Locate the **Headers** section. Look for the pre-configured header key named `X-Ometria-Auth`.
4. Paste your copied Ometria API key directly into the **Value** field next to it.
### 2. Register the Custom Event Type with Your CSM
Ometria requires custom event endpoints to be explicitly registered on your account before they will accept incoming tracking data.
- Contact your **Ometria Customer Success Manager (CSM)** and request that they create a new custom event.
- You can name this event anything you like (for example: `wishlist_item_back_in_stock`).
- Once registered, copy that exact text string, return to your Shopify Flow HTTP action block, find the payload body JSON, and update the `"event_type"` field value to match it perfectly.
### 3. Map Custom Event Properties
The template comes pre-packaged with an empty JSON `properties` block designed to let you pass supplementary data parameters over to Ometria (such as product title, image URL, or SKU).
- If you choose to transmit custom properties, you **must** inform your Ometria CSM so they can configure those exact matching property data fields against the custom event on their end.
- If you do not plan to track additional properties initially, leave the pre-configured `"properties"` key as an empty object (`{}`) in the payload body code. **Do not delete the properties key entirely.**
## Turn it on
After updating your authorization headers, matching the event type string, and verifying properties, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring inventory levels and matching restocked items against customer wishlists.
Find a product currently saved to a test customer's wishlist, set its inventory to 0, then manually increase its stock in your Shopify admin to confirm the workflow loops through and triggers the HTTP request successfully.
Ensure that the event name registered by your Ometria CSM matches the "event_type" string inside the Shopify Flow JSON payload text exactly. If there is a typo or a case-sensitivity mismatch, Ometria's API pipeline will drop the data payload entirely.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where stock levels rise from zero. When this occurs, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, running an internal HTTP POST request that transmits the event directly to Ometria's data pipeline for each subscriber—giving your marketing engine the precise trigger needed to power automated "Back in Stock" recovery tracks.
---
### Send Wishlist Item Low Stock Event to Ometria
**URL:** https://wysh.mantledocs.com/send-wishlist-item-low-stock-event-to-ometria
Use this Shopify Flow template to automatically fire an event to Ometria whenever a product variant on a shopper's wishlist falls below a safe inventory threshold. When an item's stock drops to **2 units or fewer** by default, this workflow instantly cross-references your active Wysh wishlist data to find every subscriber who has saved it, executing an automated HTTP request for each matching profile.
The data payload is completely pre-populated with customer and product variant variables, giving you an immediate hook to trigger high-conversion urgency emails or cross-channel retail campaigns before an item completely sells out.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Ometria account** with administrator privileges is required to generate API credentials.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock drops.
This template relies on a custom API connection rather than a native app block. Once configured, it pairs your real-time inventory level dips with subscriber intent data to create an automated low-stock marketing trigger. You must coordinate with Ometria to register your custom event types and map variables before activating the flow.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/47dcbcc2-46ee-4a5a-a6fe-c3426cc58d3e/wysh_ometria_wishlist_item_low_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory trigger, the stock condition check, the Wysh loop block, and the **Send HTTP request** action.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Ometria security token and verify your custom event endpoints before activating it.
### 1. Configure Your Ometria API Key Authorization
1. Log in to your **Ometria dashboard** and navigate to your integration/settings menu to generate a new **API Key**.
2. Open your imported workflow within **Shopify Flow** and click on the **Send HTTP request** action block located inside the loop block.
3. Locate the **Headers** section. Look for the pre-configured header key named `X-Ometria-Auth`.
4. Paste your copied Ometria API key directly into the **Value** field next to it.
### 2. Register the Custom Event Type with Your CSM
Ometria requires custom event endpoints to be explicitly registered on your account before they will accept incoming tracking data.
- Contact your **Ometria Customer Success Manager (CSM)** and request that they create a new custom event.
- You can name this event anything you like (for example: `wishlist_item_low_in_stock`).
- Once registered, copy that exact text string, return to your Shopify Flow HTTP action block, find the payload body JSON, and update the `"event_type"` field value to match it perfectly.
### 3. Update Settings and Map Custom Event Properties
- **Adjust the stock threshold:** The workflow triggers when product inventory is **less than or equal to 2** by default. You can change this number in the condition block to any minimum threshold that matches your fulfillment speeds.
- **Map Properties:** The template comes pre-packaged with an empty JSON `properties` block designed to let you pass supplementary data parameters over to Ometria (such as current stock count or product details). If you choose to transmit custom properties, you **must** inform your Ometria CSM so they can configure those exact matching property data fields on their end. If not, leave the pre-configured `"properties"` key as an empty object (`{}`). Do not delete the key entirely.
## Turn it on
After updating your authorization headers, adjusting your stock thresholds, and matching the event type string, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring inventory levels and matching low-stock items against customer wishlists.
Find a product currently saved to a test customer's wishlist, manually lower its inventory count to 2 or fewer in your Shopify admin, and confirm inside Shopify Flow's activity log that the workflow loops through and triggers the HTTP request successfully.
Ensure that the event name registered by your Ometria CSM matches the "event_type" string inside the Shopify Flow JSON payload text exactly. If there is a typo or a case-sensitivity mismatch, Ometria's API pipeline will drop the data payload entirely.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where stock levels drop down to your chosen minimum (default is 2). When this threshold is crossed, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, running an internal HTTP POST request that transmits the event directly to Ometria's data pipeline for each subscriber—giving your retention system the precise trigger needed to power automated "Low Stock" urgency tracks.
---
### Send Wishlist Created Event to Ometria
**URL:** https://wysh.mantledocs.com/send-wishlist-created-event-to-ometria
Use this Shopify Flow template to automatically fire an event to Ometria whenever a shopper creates their very first wishlist or opens a new curated collection on your storefront. This workflow runs instantly behind the scenes, packaging the shopper's identity and list profile data into a lightweight HTTP request.
The data payload is completely pre-populated with customer and template variables, giving you an immediate hook to drop high-intent subscribers into tailored email welcome sequences, profile onboarding tracks, or custom segment buckets the exact moment they show deep interest in your catalog.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Ometria account** with administrator privileges is required to generate API credentials.
This template relies on a custom API connection rather than a native app block. Once configured, you must coordinate with Ometria to register your custom event types and map any supplemental tracking variables before activating the flow.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/892285d3-0687-4809-9f46-36f617563685/wysh_ometria_wishlist_created.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the Wysh wishlist creation trigger and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Ometria security token and verify your custom event endpoints before activating it.
### 1. Configure Your Ometria API Key Authorization
1. Log in to your **Ometria dashboard** and navigate to your integration/settings menu to generate a new **API Key**.
2. Open your imported workflow within **Shopify Flow** and click on the **Send HTTP request** action block.
3. Locate the **Headers** section. Look for the pre-configured header key named `X-Ometria-Auth`.
4. Paste your copied Ometria API key directly into the **Value** field next to it.
### 2. Register the Custom Event Type with Your CSM
Ometria requires custom event endpoints to be explicitly registered on your account before they will accept incoming tracking data.
- Contact your **Ometria Customer Success Manager (CSM)** and request that they create a new custom event.
- You can name this event anything you like (for example: `new_wishlist_created`).
- Once registered, copy that exact text string, return to your Shopify Flow HTTP action block, find the payload body JSON, and update the `"event_type"` field value to match it perfectly.
### 3. Map Custom Event Properties
The template comes pre-packaged with an empty JSON `properties` block designed to let you pass supplementary data parameters over to Ometria (such as the specific name the user gave their wishlist).
- If you choose to transmit custom properties, you **must** inform your Ometria CSM so they can configure those exact matching property data fields against the custom event on their end.
- If you do not plan to track additional properties initially, leave the pre-configured `"properties"` key as an empty object (`{}`) in the payload body code. **Do not delete the properties key entirely.**
## Turn it on
After updating your authorization headers, matching the event type string, and verifying properties, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring your storefront and streaming wishlist creation metrics straight to Ometria.
Create a test customer account on your storefront, initialize a new wishlist, and confirm inside Shopify Flow's activity log that the workflow runs and executes the HTTP request successfully.
Ensure that the event name registered by your Ometria CSM matches the "event_type" string inside the Shopify Flow JSON payload text exactly. If there is a typo or a case-sensitivity mismatch, Ometria's API pipeline will drop the data payload entirely.
## What this workflow does
Once enabled, the workflow watches for a Wysh storefront trigger indicating a customer has initialized a wishlist. Shopify Flow immediately catches the event, fetches the customer’s profile email alongside any list metadata, and executes an automated background HTTP POST request directly to Ometria's data pipeline. This instantly unlocks real-time behavioral segmentation capabilities, giving your lifecycle marketing system the precise data signal needed to trigger personalized onboarding tracks.
---
### Send Wishlist Item Added Event to Ometria
**URL:** https://wysh.mantledocs.com/send-wishlist-item-added-event-to-ometria
Use this Shopify Flow template to automatically fire an event to Ometria whenever a shopper saves an item or variant to their wishlist. This workflow runs instantly behind the scenes, packaging the shopper's profile data and the specific product details into a lightweight HTTP request.
The data payload is completely pre-populated with customer and product variant variables, giving you an immediate hook to feed real-time interest signals into your Ometria customer profiles to power automated browse abandonment or high-intent behavior sequences.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Ometria account** with administrator privileges is required to generate API credentials.
This template relies on a custom API connection rather than a native app block. Once configured, you must coordinate with Ometria to register your custom event types and map any supplemental tracking variables before activating the flow.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/ce675d05-0b6a-42fe-ab53-d314de6cf13b/wysh_ometria_wishlist_item_added.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the Wysh item addition trigger and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Ometria security token and verify your custom event endpoints before activating it.
### 1. Configure Your Ometria API Key Authorization
1. Log in to your **Ometria dashboard** and navigate to your integration/settings menu to generate a new **API Key**.
2. Open your imported workflow within **Shopify Flow** and click on the **Send HTTP request** action block.
3. Locate the **Headers** section. Look for the pre-configured header key named `X-Ometria-Auth`.
4. Paste your copied Ometria API key directly into the **Value** field next to it.
### 2. Register the Custom Event Type with Your CSM
Ometria requires custom event endpoints to be explicitly registered on your account before they will accept incoming tracking data.
- Contact your **Ometria Customer Success Manager (CSM)** and request that they create a new custom event.
- You can name this event anything you like (for example: `wishlist_item_added`).
- Once registered, copy that exact text string, return to your Shopify Flow HTTP action block, find the payload body JSON, and update the `"event_type"` field value to match it perfectly.
### 3. Map Custom Event Properties
The template comes pre-packaged with an empty JSON `properties` block designed to let you pass supplementary data parameters over to Ometria (such as the product ID, title, or price).
- If you choose to transmit custom properties, you **must** inform your Ometria CSM so they can configure those exact matching property data fields against the custom event on their end.
- If you do not plan to track additional properties initially, leave the pre-configured `"properties"` key as an empty object (`{}`) in the payload body code. **Do not delete the properties key entirely.**
## Turn it on
After updating your authorization headers, matching the event type string, and verifying properties, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring your storefront and streaming wishlist item additions straight to Ometria.
Find a product on your storefront, add it to a test customer's wishlist, and confirm inside Shopify Flow's activity log that the workflow runs and executes the HTTP request successfully.
Ensure that the event name registered by your Ometria CSM matches the "event_type" string inside the Shopify Flow JSON payload text exactly. If there is a typo or a case-sensitivity mismatch, Ometria's API pipeline will drop the data payload entirely.
## What this workflow does
Once enabled, the workflow watches for a Wysh storefront trigger indicating an item has been saved. Shopify Flow immediately catches the event, fetches the customer’s profile email alongside the product and variant metrics, and executes an automated background HTTP POST request directly to Ometria's data pipeline. This instantly passes granular behavioral data to your dashboard, allowing you to build real-time audience segments based on explicit item interest.
---
### Send Wishlist Reminder Event to Klaviyo
**URL:** https://wysh.mantledocs.com/send-wishlist-reminder-event-to-klaviyo
Use this Shopify Flow template to send a Klaviyo event after a shopper adds an item to their wishlist in Wysh. By default, the event is sent **2 days later**, making it easy to build wishlist reminder emails that bring shoppers back to complete their purchase.
You can keep the default timing or change the wait period in Shopify Flow to match your reminder strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Klaviyo** must be set up, and you will need your **Klaviyo Public API Key** to finish the workflow configuration.
The template sends a Klaviyo event for wishlist activity. Once the event is being sent successfully, you can use it in Klaviyo to trigger or segment your reminder emails.
## Install the workflow
Download the template, then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/1c969468-4088-4fa9-b049-26f583e17927/wysh_klaviyo_wishlist_reminder.flow.zip)
Download the ZIP folder using the button above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the wait step and the Klaviyo event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Add your Klaviyo Public API Key:** Replace the placeholder value in the Klaviyo step with the Public API Key from your Klaviyo account.
- **Confirm the event name:** The default event name is `Wishlist reminder`. Keep it as-is or rename it if you want to organize events differently in Klaviyo.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Klaviyo for your email setup.
- **Adjust the wait time if needed:** The workflow waits **2 days** by default before sending the Klaviyo event. You can change this timing in Shopify Flow to seconds, minutes, hours, days, or weeks.
If you want to test different reminder timings, duplicate the workflow and use different wait periods or event names for each version.
## Turn it on
After updating the API key and any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for new wishlist activity from Wysh.
Add an item to a wishlist in your storefront, then confirm the workflow runs as expected and the event appears in Klaviyo after the configured delay.
If the workflow is not turned on, no Klaviyo events will be sent and your reminder emails will not trigger.
## What this workflow does
Once enabled, the workflow watches for shoppers who add products to their wishlist in Wysh. After the configured delay, it sends a Klaviyo event with details about the shopper, wishlist, and product. You can then use that event in Klaviyo to power wishlist reminder emails.
---
### Klaviyo Automations
**URL:** https://wysh.mantledocs.com/klaviyo-automations
Syncing Wysh with Klaviyo lets you capitalize on deep shopper intent. Instead of generic blast emails, you can trigger hyper-personalized messages based on the exact products your customers are saving to their wishlists.
Once your workflow templates are active inside Shopify Flow, event metrics automatically route straight into your Klaviyo account to power custom behavioral segmentation and highly optimized email retention tracks.
## Available Templates
Browse and install our pre-built Shopify Flow templates for Klaviyo:
- [New Wishlist Created](/send-wishlist-created-event-to-klaviyo) **:** Fire automated onboarding or welcome email tracks when a customer sets up their first list.
- [Item Added to Wishlist](/send-wishlist-item-added-event-to-klaviyo) **:** Pass high-intent behavior metrics straight to Klaviyo to set up custom browse or wishlist abandonment sequences.
- [Wishlist Reminder](/send-wishlist-reminder-event-to-klaviyo): Automatically nudge shoppers about items left sitting on their lists after a specific delay.
- [Item Removed from Wishlist](/send-item-removed-from-wishlist-event-to-klaviyo): Keep your audience segment lists cleanly synchronized when preferences change and saved items are cleared.
- [Low Stock Alert](/send-wishlist-item-low-in-stock-event-to-klaviyo): Capitalize on immediate purchase intent by messaging shoppers when their saved items are running low.
- [Back in Stock Alert](/send-wishlist-item-back-in-stock-event-to-klaviyo): Instantly alert shoppers via email the second an out-of-stock item on their wishlist is replenished.
---
### Features Overview
**URL:** https://wysh.mantledocs.com/features-overview
In this area, you’ll find guidance on the available features within Wysh and how to use them.
---
### Send Wishlist Item Added Event to Attentive
**URL:** https://wysh.mantledocs.com/send-wishlist-item-added-event-to-attentive
Use this Shopify Flow template to send a custom event to Attentive whenever a shopper adds an item to their wishlist in Wysh. Because Attentive uses custom API events, this workflow leverages Shopify Flow's built-in HTTP request capability to securely post data straight to your Attentive dashboard—allowing you to trigger high-impact SMS automation journeys based on active subscriber intent.
The data payload is entirely pre-configured, so you only need to connect your security credentials.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Attentive account** with administrator privileges is required to generate custom app credentials.
This template relies on a custom API connection rather than a native app block. Once configured, it streams real-time customer behavior directly into your text marketing engine.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/f7c8dab0-c2a8-48db-aff3-a14b1fef2b5e/wysh_attentive_wishlist_item_added.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item addition trigger and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Attentive security token to the request headers before activating it.
### 1. Generate your Attentive API Token
1. Log in to your **Attentive dashboard** and navigate to your integration/developer settings.
2. Create a new **Custom App**.
3. During setup, ensure you grant **Write** access permissions to **Custom Events**.
4. Generate the app and copy the provided API key/token to your clipboard.
### 2. Update the Shopify Flow Header
- Open the **Send HTTP request** step inside the imported workflow.
- Locate the **Headers** section.
- Find the field containing the word `Bearer`.
- Paste your copied Attentive token directly into the **Value** field right after the word `Bearer` (make sure to leave a single space between "Bearer" and your token string, e.g., `Bearer your_token_here`).
> **Important:** The request body and data payload are already fully configured and pre-populated with correct template variables mapping customer emails and product details. **Do not modify the payload code**, as doing so may cause the API tracking to fail.
## Turn it on
After pasting your token into the header field, save the workflow in Shopify Flow.
Turn the workflow on so it can begin capturing storefront wishlist activity and passing it to Attentive.
Add an item to a wishlist on your storefront using a test account. Check your Shopify Flow run history to confirm that the HTTP status returns a successful response code.
Events can take up to 1 hour to fully process and appear in your Attentive dashboard after Shopify sends them. If you do not see the custom event in Attentive immediately during testing, allow up to 60 minutes for the pipeline to update.
## What this workflow does
Once enabled, the workflow watches for shoppers who add items to their wishlist in Wysh. It instantly packages the shopper's contact profile and product data, and runs an internal HTTP Post request that transmits the event directly to the Attentive Custom Events API. This provides you with the foundational behavioral trigger needed to power automated "Wishlist Item Added" text message marketing campaigns.
---
### Reward Points on LoyaltyLion on Wishlist Item Purchased
**URL:** https://wysh.mantledocs.com/reward-points-on-loyaltylion-on-wishlist-item-purchased
Use this Shopify Flow template to automatically reward your loyalty members whenever they complete a purchase on an item from their Wysh wishlist. By default, the workflow instantly awards **150 loyalty points** to the customer, making it easy to incentivize and reward high-intent buying behavior that drives conversion revenue.
You can keep our default point value or customize the points and reward reasons to align with your overall loyalty program strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **LoyaltyLion** must be connected directly to your Shopify store so Shopify Flow can seamlessly communicate with your loyalty program data.
The template pairs completed checkout orders with a customer's active wishlist data. Once configured, it dynamically tracks wishlist conversions and deposits points straight into the shopper's loyalty account.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/1c82856e-187f-43fe-a3ea-f48f3a116e45/wysh_loyalty_lion_wishlist_item_purchased.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the order trigger, the wishlist cross-reference check, and the LoyaltyLion point action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Adjust the point value:** The workflow defaults to awarding **150 points** per conversion. You can modify this number inside the LoyaltyLion step to match your current points-to-currency reward values.
- **Update the reward reason:** We pre-fill this field with a clear internal explanation for your tracking. You can rewrite this text to match your specific customer-facing ledger title or internal audit notes.
- **Leave the email field as-is:** The customer email address field is already pre-populated with the exact template variable needed to accurately identify your loyalty program users. **Do not alter or delete this variable**, or the system will fail to link points to the correct profile.
Because LoyaltyLion features a native connection with your store, you don't need to hunt down API keys or security hashes. Simply make sure the app is fully set up in your Shopify store admin before turning the workflow on.
## Turn it on
After updating your point quantities and reviewing the reward variables, save the workflow in Shopify Flow.
Turn the workflow on so it can start tracking successful wishlist checkout conversions across your storefront.
Place a test order on your storefront using an account that has that product saved to their wishlist, then confirm that the 150 loyalty points are successfully credited to that customer's LoyaltyLion profile.
If the workflow remains turned off, wishlist conversions will execute without depositing loyalty points, missing a key opportunity to reward customer retention.
## What this workflow does
Once enabled, the workflow watches for completed checkout orders across your store. When an order includes a product variant currently saved to that specific customer's Wysh data, it triggers a point transaction. The system automatically pulls the shopper's email, matches it to their LoyaltyLion profile, and adds 150 points (or your custom value) to their account balances under your specified transaction reason.
---
### How to save products to a wishlist
**URL:** https://wysh.mantledocs.com/save-products-to-a-wishlist
## Save products for later
Customers can save products they are not ready to buy yet by adding them to **My Wishlist**. On the product page, the wishlist icon appears beside the main purchase actions, including **Add to cart** and **Buy it now**.
## How customers add an item to their wishlist
Customers should sign in to their store account before saving wishlist items so their saved products are linked to them for later.
From the storefront, open the product you want to save.
On the product page, click the wishlist icon next to **Add to cart** and **Buy it now**. This saves the product to **My Wishlist** instead of adding it to checkout right away.
Customers can visit other product pages and use the same wishlist icon to build up a saved list for a future purchase.
When ready, open **My Wishlist** by clicking the wishlist icon in the header to see saved items, prices, and product-level **Add to cart** buttons.
## What customers can do from My Wishlist
After saving products, customers can use the wishlist page to manage or act on those items later.
- **Add to cart** to move an individual saved item toward checkout
- **Share Wishlist** to send the saved list to the store
If a customer is still comparing products, the wishlist is a good way to keep options in one place without committing to checkout yet.
## When to use the wishlist instead of buying now
- When a customer wants to come back and purchase later
- When they are comparing several products before deciding
- When they want to save ideas in one place before sharing them
## Important notes
If a customer is not signed in, saved items may not be tied to their account in the same way. For the most reliable wishlist experience, ask customers to sign in first.
## FAQ
It appears beside the main purchase actions on the product page, next to **Add to cart** and **Buy it now**.
No. Saving with the wishlist icon adds the product to **My Wishlist**. It does not start checkout.
Yes. On **My Wishlist**, each saved item can show its own **Add to cart** button so the customer can purchase when ready.
Yes. Customers can use **Share Wishlist** from **My Wishlist** to send their saved list to the store.
---
### Send Wishlist Item Back in Stock Event to Mailchimp
**URL:** https://wysh.mantledocs.com/send-wishlist-item-back-in-stock-event-to-mailchimp
Use this Shopify Flow template to automatically notify shoppers when an item on their wishlist comes back in stock. When a product's inventory increases from zero, the workflow automatically checks for any shoppers who have added that specific product to their Wysh wishlist, and instantly sends a Mailchimp event to each of them.
This creates a highly relevant, automated touchpoint that instantly alerts high-intent buyers the moment their favorite items are available for purchase again.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Mailchimp** must be connected directly to your Shopify store so Shopify Flow can seamlessly pass data to your Mailchimp account.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock increases.
The template connects your restocked inventory directly with customer wishlists. Once the back-in-stock event is being sent successfully, you can use it in Mailchimp to trigger automated back-in-stock customer journeys.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/b1ff1afd-2f9c-4db4-af94-aaf758f5d2dc/wysh_mailchimp_wishlist_item_back_in_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory quantity trigger, the Wysh wishlist loop check, and the Mailchimp event action step.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Confirm the event name:** The default event name sent to Mailchimp is `Wishlist item back in stock`. Keep it as-is or rename it if you want to organize events differently in Mailchimp.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Mailchimp so your restock email can display the correct product imagery, title, and price details.
- **Verify stock rules:** Ensure the workflow triggers only when inventory goes from 0 to greater than 0, preventing accidental alerts during normal inventory adjustments or manual counting corrections.
When building your back-in-stock automated customer journey in Mailchimp, include a clean, highly visible product callout that drives customers directly back to your storefront product page to speed up conversions.
## Turn it on
After verifying your workflow conditions and parameters, save the workflow in Shopify Flow.
Turn the workflow on so it can start monitoring your store for product restocks and matching them to customer wishlists.
Find a product currently saved to a test customer's wishlist, set its inventory to 0, then increase it back to 1 or more in your Shopify admin. Confirm the workflow loops through the customers and fires the event to Mailchimp.
If the workflow is not turned on, back-in-stock events will pass unmonitored, and your shoppers will not receive automatic updates when items return to stock.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where a product variant goes from out-of-stock back into stock. When this restock occurs, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, sending an individual `Wishlist item back in stock` event to Mailchimp for each one—giving you the precise trigger needed to capture high-intent recovery revenue.
---
### Send Wishlist Item Back in Stock Event to Attentive
**URL:** https://wysh.mantledocs.com/send-wishlist-item-back-in-stock-event-to-attentive
Use this Shopify Flow template to automatically fire an event to Attentive whenever an out-of-stock item on a customer's wishlist becomes available again. When a product variant's inventory level increases from zero, this workflow scans your Wysh wishlist data, finds the shoppers who saved that item, and executes a secure HTTP request for each person.
The data payload is completely pre-configured to pass the relevant subscriber profiles and product fields, giving you an immediate hook to trigger back-in-stock SMS notifications.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Attentive account** with administrator privileges is required to generate custom app credentials.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock increases.
This template relies on a custom API connection rather than a native app block. Once configured, it lets you capture high-intent recovery revenue by letting subscribers know via text exactly when their items return.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/b9bdf922-f911-47e1-b9e4-7ee20123eaa5/wysh_attentive_wishlist_item_back_in_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory trigger, the Wysh data loop check, and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Attentive security token to the request headers before activating it.
### 1. Generate your Attentive API Token
1. Log in to your **Attentive dashboard** and navigate to your integration/developer settings.
2. Create a new **Custom App**.
3. During setup, ensure you grant **Write** access permissions to **Custom Events**.
4. Generate the app and copy the provided API key/token to your clipboard.
### 2. Update the Shopify Flow Header
- Open the **Send HTTP request** step located inside the loop block of the imported workflow.
- Locate the **Headers** section.
- Find the field containing the word `Bearer`.
- Paste your copied Attentive token directly into the **Value** field right after the word `Bearer` (make sure to leave a single space between "Bearer" and your token string, e.g., `Bearer your_token_here`).
> **Important:** The request body and data payload are already fully configured and pre-populated with correct template variables mapping customer emails and product details. **Do not modify the payload code**, as doing so may cause the API tracking to fail.
## Turn it on
After pasting your token into the header field, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring inventory changes and passing restock events to Attentive.
Find an item saved to a test user's wishlist, set its inventory to 0, then bump it back to 1 or more in your admin. Check your Shopify Flow history to confirm that the HTTP status returns a successful response code.
Events can take up to 1 hour to fully process and appear in your Attentive dashboard after Shopify sends them. If you do not see the custom event in Attentive immediately during testing, allow up to 60 minutes for the pipeline to update.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where a product variant goes from out-of-stock back into stock. When this restock occurs, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, running an internal HTTP Post request that transmits the event directly to the Attentive Custom Events API for each subscriber—giving you the precise trigger needed to power automated "Wishlist Item Back In Stock" text message alerts.
---
### Mailchimp Automations
**URL:** https://wysh.mantledocs.com/mailchimp-automations
Turn static wishlist actions into dynamic, targeted customer journeys. By passing Wysh events into Mailchimp, you can automatically organize your audience list and put your product engagement marketing on autopilot.
Once active inside Shopify Flow, real-time subscriber behavioral data syncs straight over to your marketing dashboard, allowing you to seamlessly maintain list hygiene, update subscriber tags, and trigger custom automation sequences.
## Available Templates
Browse and install our pre-built Shopify Flow templates for Mailchimp:
- [New Wishlist Created](/send-wishlist-created-event-to-mailchimp) **:** Welcome shoppers early and drop them into customized buyer onboarding tracks when they build their first list.
- [Item Added to Wishlist](/send-wishlist-item-added-event-to-mailchimp) **:** Automatically tag subscribers or fire high-intent browse engagement sequences as soon as an item is favorited.
- [Wishlist Reminder](/send-wishlist-reminder-event-to-mailchimp) **:** Nudge customers automatically after a set delay to revisit the products left sitting in their wishlists.
- [Item Removed from Wishlist](/send-wishlist-item-removed-event-to-mailchimp) **:** Keep list data perfectly clean and adjust active contact tags when users drop items from their profiles.
- [Low Stock Alert](/send-wishlist-item-low-stock-event-to-mailchimp) **:** Drive conversion urgency by letting subscribers know via email when a favorited product runs low.
- [Back in Stock Alert](/send-wishlist-item-back-in-stock-event-to-mailchimp) **:** Recover missed opportunities by instantly mailing subscribers the moment their saved out-of-stock items return.
---
### Send Wishlist Created Event to Klaviyo
**URL:** https://wysh.mantledocs.com/send-wishlist-created-event-to-klaviyo
Use this Shopify Flow template to send a Klaviyo event after a shopper creates a new wishlist in Wysh. By default, the event is sent immediately, making it easy to trigger a welcoming automated email flow that encourages them to start adding their favorite items.
You can customize the workflow in Shopify Flow to match your specific marketing or segmenting strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Klaviyo** must be set up, and you will need your **Klaviyo Public API Key** to finish the workflow configuration.
The template sends a Klaviyo event for new wishlist creation activity. Once the event is being sent successfully, you can use it in Klaviyo to trigger or segment your wishlist welcome emails.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/70160796-4499-45a1-84bd-27108a196061/wysh_klaviyo_wishlist_created.flow)
Download the ZIP folder using the button above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the wishlist trigger and the Klaviyo event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Add your Klaviyo Public API Key:** Replace the placeholder value in the Klaviyo step with the Public API Key from your Klaviyo account.
- **Confirm the event name:** The default event name is `New wishlist created`. Keep it as-is or rename it if you want to organize events differently in Klaviyo.
- **Review the event details:** Make sure the event includes the shopper information you want available in Klaviyo for your email setup.
- **Adjust timing if needed:** By default, this event is sent immediately. If you want to introduce a delay, you can add a wait step in Shopify Flow and set it to seconds, minutes, hours, days, or weeks.
If you want to track different variations of wishlist creations, you can duplicate the workflow and assign different event names or delays for specific customer types.
## Turn it on
After updating the API key and any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for new wishlist creation activity from Wysh.
Create a new wishlist on your storefront as a test shopper, then confirm the workflow runs as expected and the event appears in Klaviyo.
If the workflow is not turned on, no Klaviyo events will be sent and your wishlist welcome emails will not trigger.
## What this workflow does
Once enabled, the workflow watches for shoppers who create a brand new wishlist in Wysh. It immediately sends a Klaviyo event with details about the shopper and the newly created wishlist. You can then use that event in Klaviyo to power automated wishlist onboarding or engagement emails.
---
### How to create Multiple wishlists
**URL:** https://wysh.mantledocs.com/multiple-wishlists
## Save products to multiple wishlists
Wysh lets customers create and manage more than one wishlist. This is useful when they want to organise saved products into separate lists, such as gifts, personal favourites, or different projects.
When a customer has only one list, the storefront uses the label **My Wishlist**. After they create more than one wishlist, that area is renamed to **My Lists**.
Customers create extra lists from the **My Wishlist** page using **Create New List**.
## Create a new wishlist
Go to the storefront wishlist page. If the customer only has one list, it appears as **My Wishlist**. On the wishlist page, click **Create New List**. After the new list is created, the customer can save products to that specific list and switch between lists from the wishlist area. Once a customer has more than one wishlist, the page label changes from **My Wishlist** to **My Lists**.
## Choose a wishlist from a product page
On product pages, the standard wishlist action changes when multiple wishlists are available.
- The customer uses the **Add to wishlist** action on the product page.
- Instead of saving to a single default list automatically, the wishlist control shows a **drop-down**.
- The customer can choose which wishlist the product should be added to.
This makes it easier to keep saved items organised without needing to move them later.
## What changes for customers
- **One list:** the storefront shows **My Wishlist**.
- **More than one list:** the storefront shows **My Lists**.
- **Product pages:** the wishlist button includes a drop-down so the customer can choose the correct list.
If a customer wants to separate saved items by occasion or category, have them create multiple lists first from **My Wishlist**, then choose the right list directly from each product page.
## Related wishlist actions
Customers can still use the existing wishlist experience alongside multiple lists, including the storefront wishlist page and **Share Wishlist** where available.
---
### Send Wishlist Item Removed Event to Attentive
**URL:** https://wysh.mantledocs.com/send-wishlist-item-removed-event-to-attentive
Use this Shopify Flow template to send a custom event to Attentive whenever a shopper removes an item from their wishlist in Wysh. By using Shopify Flow's built-in HTTP request action, this workflow safely pushes customer preference changes directly to your Attentive dashboard. This enables you to maintain clean data hygiene or trigger custom SMS retention strategies based on active subscriber opt-outs from specific product styles.
The data payload is completely pre-configured, meaning you only need to insert your specific security token.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Attentive account** with administrator privileges is required to generate custom app credentials.
This template relies on a custom API connection rather than a native app block. Once configured, it seamlessly communicates removal events from your storefront directly into your subscriber metrics database.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/92d5dc8e-d417-4a0e-ac69-1f280d562bc4/wysh_attentive_wishlist_item_removed.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item removal trigger and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Attentive security token to the request headers before activating it.
### 1. Generate your Attentive API Token
1. Log in to your **Attentive dashboard** and navigate to your integration/developer settings.
2. Create a new **Custom App**.
3. During setup, ensure you grant **Write** access permissions to **Custom Events**.
4. Generate the app and copy the provided API key/token to your clipboard.
### 2. Update the Shopify Flow Header
- Open the **Send HTTP request** step inside the imported workflow.
- Locate the **Headers** section.
- Find the field containing the word `Bearer`.
- Paste your copied Attentive token directly into the **Value** field right after the word `Bearer` (make sure to leave a single space between "Bearer" and your token string, e.g., `Bearer your_token_here`).
> **Important:** The request body and data payload are already fully configured and pre-populated with correct template variables mapping customer emails and product details. **Do not modify the payload code**, as doing so may cause the API tracking to fail.
## Turn it on
After pasting your token into the header field, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring wishlist removal activity and passing it over to Attentive.
Remove an item from a wishlist on your storefront using a test account. Check your Shopify Flow run history to confirm that the HTTP status returns a successful response code.
Events can take up to 1 hour to fully process and appear in your Attentive dashboard after Shopify sends them. If you do not see the custom event in Attentive immediately during testing, allow up to 60 minutes for the pipeline to update.
## What this workflow does
Once enabled, the workflow watches for shoppers who remove items from their wishlist in Wysh. It instantly packages the shopper's contact profile and product data, and runs an internal HTTP Post request that transmits the event directly to the Attentive Custom Events API. This allows you to track changing consumer preferences and adapt subscriber data fields automatically inside your platform profile logs.
---
### Send Wishlist Item Removed Event to Klaviyo
**URL:** https://wysh.mantledocs.com/send-item-removed-from-wishlist-event-to-klaviyo
Use this Shopify Flow template to send a Klaviyo event after a shopper removes an item from their wishlist in Wysh. By default, the event is sent immediately, making it easy to track changes in customer interest or build automation strategies around updated shopper preferences.
You can customize the workflow in Shopify Flow to match your specific marketing or segmenting strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Klaviyo** must be set up, and you will need your **Klaviyo Public API Key** to finish the workflow configuration.
The template sends a Klaviyo event for wishlist item removals. Once the event is being sent successfully, you can use it in Klaviyo to monitor shifts in user intent or update targeted customer segments.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/73e89445-4f66-4aa2-9627-dc608994b83b/wysh_klaviyo_wishlist_item_removed.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item removal trigger and the Klaviyo event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Add your Klaviyo Public API Key:** Replace the placeholder value in the Klaviyo step with the Public API Key from your Klaviyo account.
- **Confirm the event name:** The default event name is `Item removed from wishlist`. Keep it as-is or rename it if you want to organize events differently in Klaviyo.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Klaviyo for your setup.
- **Adjust timing if needed:** By default, this event is sent immediately. If you want to introduce a delay, you can add a wait step in Shopify Flow and set it to seconds, minutes, hours, days, or weeks.
If you want to track multiple types of removal behaviors, you can duplicate the workflow and assign different event names or delays based on custom conditions.
## Turn it on
After updating the API key and any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist removal activity from Wysh.
Remove an item from a wishlist on your storefront as a test shopper, then confirm the workflow runs as expected and the event appears in Klaviyo.
If the workflow is not turned on, no Klaviyo events will be sent when products are removed from a wishlist.
## What this workflow does
Once enabled, the workflow watches for shoppers who remove items from their wishlist in Wysh. It immediately sends a Klaviyo event with details about the shopper and the removed product. You can then use that event in Klaviyo to refine customer profiles, build clean segments, or adjust automated triggers based on active intent.
---
### Send Slack Message on Wishlist Item Removed
**URL:** https://wysh.mantledocs.com/send-slack-message-on-wishlist-item-removed
Use this Shopify Flow template to send a Slack notification automatically whenever a shopper removes an item from their wishlist in Wysh. By default, the message is sent immediately to your specified channel, giving your product and merchandising teams quick visibility into shifts in customer interest or catalog demand.
You can use our default message layout or completely customize the text to match your internal reporting style.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Slack** must be integrated with your Shopify store, and you must have a specific channel ready (e.g., `#wishlist-activity` or `#product-insights`) where Shopify Flow can post messages.
The template sends a notification to Slack for wishlist item removals. Once configured, it helps your team track items that customers are dropping from their lists in real time.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/b8b96323-2c44-44d2-839e-d2c0484c6474/wysh_slack_wishlist_item_removed.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item removal trigger and the Slack message action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Select your Slack channel:** Open the Slack step in the workflow and choose the exact channel where you want these removal alerts to post.
- **Customize the message text:** Review our default message copy. You can change this text block in Shopify Flow to include template variables, such as the specific product title, variant name, or customer contact details.
- **Filter your notifications:** If you only want to monitor removals for high-value items, you can add an optional condition step to only send a message if the product price is above a certain amount.
Including variables like the product's SKU or variant title in your Slack message makes it easy for your merchandising team to track which specific variations are losing momentum.
## Turn it on
After choosing your channel and tailoring the notification text, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist removal activity from Wysh.
Remove an item from a wishlist on your storefront as a test shopper, then confirm the message posts to your chosen Slack channel immediately.
If a valid Slack channel is not selected or the workflow is left disabled, no removal alerts will be pushed to your workspace.
## What this workflow does
Once enabled, the workflow watches for shoppers who remove items from their wishlist in Wysh. It immediately packages the activity details—including the shopper and product information—into a clear notification and pushes it into your designated Slack channel. This gives your internal teams instant visibility into real-time catalog changes without leaving your daily chat application.
---
### Slack Notifications
**URL:** https://wysh.mantledocs.com/slack-notifications
Keep your internal workspace aligned without pulling constant dashboard reports. Integrating Wysh with Slack gives your product, merchandising, and customer success teams real-time visibility into active buyer trends and high-intent checkout wins directly inside your daily chat application.
Once active inside Shopify Flow, storefront wishlist updates instantly broadcast to your designated team channels, helping you monitor inventory demand and celebrate catalog conversions as they happen.
## Available Templates
Browse and install our pre-built Shopify Flow templates for Slack:
- [New Wishlist Created](/send-slack-message-on-wishlist-creation) **:** Get instant visibility the moment a shopper reaches a new brand engagement milestone on your storefront.
- [Item Added to Wishlist](/send-slack-message-on-wishlist-item-added) **:** Keep tabs on hot products by streaming real-time catalog additions straight to your merchandising channels.
- [Item Removed from Wishlist](/send-slack-message-on-wishlist-item-removed) **:** Monitor shifts in consumer taste and tracking trends where items lose momentum.
- [Purchased Item from Wishlist](/send-slack-message-on-wishlist-item-purchased) **:** Celebrate direct revenue wins by alerting your team channels whenever a wishlist item converts at checkout.
---
### LoyaltyLion Rewards
**URL:** https://wysh.mantledocs.com/loyaltylion-rewards
Supercharge your customer retention engine by rewarding high-intent buying behavior. Integrating Wysh with LoyaltyLion lets you gamify your storefront strategy by automatically issuing loyalty points when shoppers successfully purchase items from their wishlists.
Once active inside Shopify Flow, this behavior lifecycle link bridges user purchase events directly with your rewards ledger, allowing you to strengthen brand loyalty and encourage customers to actively maintain and clear out their saved collections.
## Available Templates
Browse and install our pre-built Shopify Flow templates for LoyaltyLion:
- [Purchased Item from Wishlist](/reward-points-on-loyaltylion-on-wishlist-item-purchased) **:** Incentivize repeat buying patterns by automatically granting loyalty points to members the moment they check out with an item saved to their wishlist.
---
### Send Wishlist Reminder Event to Attentive
**URL:** https://wysh.mantledocs.com/send-wishlist-reminder-event-to-attentive
Use this Shopify Flow template to send a custom event to Attentive after a shopper adds an item to their wishlist in Wysh. By default, the workflow schedules a **2-day wait period** before using Shopify Flow's built-in HTTP request capability to securely pass the reminder event to Attentive—allowing you to trigger high-impact automated SMS reminders to recover high-intent shoppers.
The data payload is entirely pre-configured, so you only need to connect your security credentials.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Attentive account** with administrator privileges is required to generate custom app credentials.
This template relies on a custom API connection rather than a native app block. Once configured, it streams delayed reminder events into your text marketing engine to prompt subscribers to take a second look at their saved items.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/e06d7f8d-3f6d-420e-88dd-70a8aa2bc9ee/wysh_attentive_wishlist_reminder.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item addition trigger, the wait block, and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Attentive security token to the request headers before activating it.
### 1. Generate your Attentive API Token
1. Log in to your **Attentive dashboard** and navigate to your integration/developer settings.
2. Create a new **Custom App**.
3. During setup, ensure you grant **Write** access permissions to **Custom Events**.
4. Generate the app and copy the provided API key/token to your clipboard.
### 2. Update the Shopify Flow Settings
- **Adjust the wait time if needed:** The workflow is set to wait **2 days** by default before triggering the API request. You can click on the wait step inside Shopify Flow to adjust this to your preferred marketing delay window.
- **Update the HTTP Header:** Open the **Send HTTP request** step inside the imported workflow. Locate the **Headers** section, find the field containing the word `Bearer`, and paste your copied Attentive token directly into the **Value** field right after the word `Bearer` (leave a single space between "Bearer" and your token string, e.g., `Bearer your_token_here`).
> **Important:** The request body and data payload are already fully configured and pre-populated with correct template variables mapping customer emails and product details. **Do not modify the payload code**, as doing so may cause the API tracking to fail.
## Turn it on
After verifying your wait timing and pasting your token into the header field, save the workflow in Shopify Flow.
Turn the workflow on so it can begin running reminder cycles for storefront wishlist activity.
Add an item to a wishlist on your storefront using a test account. You can manually fast-forward or skip the wait period in Shopify Flow's run log to test the immediate response of the HTTP request action.
Events can take up to 1 hour to fully process and appear in your Attentive dashboard after Shopify sends them. If you do not see the custom event in Attentive immediately during testing, allow up to 60 minutes for the pipeline to update.
## What this workflow does
Once enabled, the workflow watches for shoppers who add items to their wishlist in Wysh. It initiates a 2-day countdown block. Once the time elapsed parameter is met, the flow packages the shopper's contact profile and product data, running an internal HTTP Post request that transmits the reminder event directly to the Attentive Custom Events API. This provides your text message marketing engine with a highly optimized trigger for running custom cart and browse recovery flows.
---
### Manage multiple wishlists
**URL:** https://wysh.mantledocs.com/manage-multiple-wishlists
## Manage saved lists in Wysh
Wysh lets customers keep more than one wishlist so they can organise saved products into separate lists.
From the wishlist page, customers can manage an existing list using the **three-dot menu** shown next to that wishlist.
Use the menu next to a specific wishlist when you want to change that list without affecting the others.
## What you can do from the three-dot menu
- **Rename** to update the list name
- **Duplicate** to create a copy of an existing wishlist
- **Delete** to remove a wishlist you no longer need
## Rename, duplicate, or delete a wishlist
Go to **My Wishlist** or **My Lists**, depending on how many wishlists you already have.
Locate the specific wishlist you want to change.
Click the **three-dot menu** next to that wishlist.
Select **Rename**, **Duplicate**, or **Delete** from the menu.
## When to use each option
### Rename
Use **Rename** when the wishlist still contains the right products, but the name no longer fits. For example, a customer might change a list name from “Gift Ideas” to “Birthday Gifts”.
### Duplicate
Use **Duplicate** when you want to make a copy of an existing wishlist without rebuilding it from scratch. This is helpful if a customer wants to reuse a list for a similar occasion or create a variation of an existing set of saved products.
### Delete
Use **Delete** when a wishlist is no longer needed and can be removed from the account.
Deleting a wishlist removes that list. Customers should make sure they no longer need it before choosing **Delete**.
## Helpful notes
If a customer wants to keep the same products but organise them differently, **Duplicate** is usually a better choice than deleting and starting over.
## Related wishlist tasks
Learn how customers save items from product pages using the wishlist icon next to Add to cart and Buy it now.
See how customers create extra lists with Create New List and switch from My Wishlist to My Lists.
---
### Send Wishlist Item Low Stock Event to Klaviyo
**URL:** https://wysh.mantledocs.com/send-wishlist-item-low-in-stock-event-to-klaviyo
Use this Shopify Flow template to automatically notify shoppers when an item on their wishlist is running low on stock. When a product's inventory decreases to a defined amount (defaulting to **2 units or fewer**), the workflow automatically checks for any shoppers who have added that specific product to their Wysh wishlist, and instantly sends a Klaviyo event to each of them.
This creates a powerful, high-conversion urgency reminder that encourages shoppers to buy before their favorite items sell out.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Klaviyo** must be set up, and you will need your **Klaviyo Public API Key** to finish the workflow configuration.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock drops.
The template connects your real-time inventory levels directly with your customer wishlists. Once the low-stock event is being sent successfully, you can use it in Klaviyo to trigger automated "Low Stock Wishlist Alert" emails.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/ba6660d1-3f77-45d0-afe5-457d85fad8d4/wysh_klaviyo_wishlist_item_low_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory trigger, the Wysh wishlist loop check, and the Klaviyo action step.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Add your Klaviyo Public API Key:** Replace the placeholder value in the Klaviyo step with the Public API Key from your Klaviyo account.
- **Adjust the stock threshold:** The workflow triggers when product inventory is **less than or equal to 2** by default. You can change this number in the condition block to any low-stock threshold that matches your inventory speeds.
- **Confirm the event name:** The default event name sent to Klaviyo is typically `Low stock of wishlist item` (or your preferred naming convention). Keep it as-is or rename it to organize events differently in Klaviyo.
- **Review customer data payload:** Ensure that the event is correctly passing the shopper's contact details and the specific product variant data so Klaviyo can dynamically populate your email template.
To avoid spamming customers, ensure your email flow in Klaviyo has a smart-sending limit or a time-delay filter so a customer doesn't receive multiple low-stock alerts in a single day if multiple items drop in inventory.
## Turn it on
After adjusting your stock thresholds and pasting your Klaviyo API key, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring inventory levels and matching low-stock items against customer wishlists.
Find a product currently saved to a test customer's wishlist, manually lower its inventory count to 2 or fewer in your Shopify admin, and confirm the workflow loops through the customers and fires the event to Klaviyo.
If the workflow is not turned on, inventory drops will pass unmonitored, and your high-intent shoppers will miss out on urgency notifications.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where stock levels drop down to your chosen minimum (default is 2). When this threshold is crossed, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, sending an individual Klaviyo event for each one—giving you the precise trigger needed to power automated urgency-driven email campaigns.
---
### Send Wishlist Item Back in Stock Event to Klaviyo
**URL:** https://wysh.mantledocs.com/send-wishlist-item-back-in-stock-event-to-klaviyo
Use this Shopify Flow template to automatically notify shoppers when an item on their wishlist comes back in stock. When a product's inventory increases from zero, the workflow automatically checks for any shoppers who have added that specific product to their Wysh wishlist, and instantly sends a Klaviyo event to each of them.
This creates a highly relevant, automated touchpoint that instantly alerts high-intent buyers the moment their favorite items are available for purchase again.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Klaviyo** must be set up, and you will need your **Klaviyo Public API Key** to finish the workflow configuration.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock increases.
The template connects your restocked inventory directly with customer wishlists. Once the back-in-stock event is being sent successfully, you can use it in Klaviyo to trigger automated "Back in Stock Wishlist Alert" emails.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/3e1b64f5-02df-474f-9ba9-d3be2e2c9731/wysh_klaviyo_wishlist_item_back_in_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory quantity trigger, the Wysh wishlist loop check, and the Klaviyo action step.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Add your Klaviyo Public API Key:** Replace the placeholder value in the Klaviyo step with the Public API Key from your Klaviyo account.
- **Confirm the event name:** The default event name sent to Klaviyo is `Wishlist item back in stock`. Keep it as-is or rename it if you want to organize events differently in Klaviyo.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Klaviyo so your restock email can display the correct product image, title, and price.
- **Verify stock rules:** Ensure the workflow triggers only when inventory goes from 0 to greater than 0, preventing accidental alerts during normal inventory counting adjustments.
When designing your back-in-stock email template in Klaviyo, include a clear "Buy Now" button linking directly back to the product page to make purchasing as frictionless as possible.
## Turn it on
After pasting your Klaviyo API key and verifying your workflow conditions, save the workflow in Shopify Flow.
Turn the workflow on so it can start monitoring your store for product restocks and matching them to customer wishlists.
Find a product currently saved to a test customer's wishlist, set its inventory to 0, then increase it back to 1 or more in your Shopify admin. Confirm the workflow loops through the customers and fires the event to Klaviyo.
If the workflow is not turned on, back-in-stock events will pass unmonitored, and your shoppers will not receive automatic updates when items return to stock.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where a product variant goes from out-of-stock back into stock. When this restock occurs, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, sending an individual `Wishlist item back in stock` event to Klaviyo for each one—giving you the precise trigger needed to capture high-intent recovery revenue.
---
### Send Wishlist Created Event to Attentive
**URL:** https://wysh.mantledocs.com/send-wishlist-created-event-to-attentive
Use this Shopify Flow template to send a custom event to Attentive whenever a shopper creates a new wishlist in Wysh. By utilizing Shopify Flow's built-in HTTP request action, this workflow safely pushes milestones in user engagement directly to your Attentive dashboard. This allows you to log early high-intent signals or trigger introductory SMS welcome tracks tailored specifically for wishlist subscribers.
The data payload is completely pre-configured, meaning you only need to insert your specific security token.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Attentive account** with administrator privileges is required to generate custom app credentials.
This template relies on a custom API connection rather than a native app block. Once configured, it seamlessly communicates creation events from your storefront directly into your subscriber metrics database.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/3e03a16c-024b-499f-907d-cb79a9bd1128/wysh_attentive_wishlist_created.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the wishlist creation trigger and the **Send HTTP request** action block.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Attentive security token to the request headers before activating it.
### 1. Generate your Attentive API Token
1. Log in to your **Attentive dashboard** and navigate to your integration/developer settings.
2. Create a new **Custom App**.
3. During setup, ensure you grant **Write** access permissions to **Custom Events**.
4. Generate the app and copy the provided API key/token to your clipboard.
### 2. Update the Shopify Flow Header
- Open the **Send HTTP request** step inside the imported workflow.
- Locate the **Headers** section.
- Find the field containing the word `Bearer`.
- Paste your copied Attentive token directly into the **Value** field right after the word `Bearer` (make sure to leave a single space between "Bearer" and your token string, e.g., `Bearer your_token_here`).
> **Important:** The request body and data payload are already fully configured and pre-populated with correct template variables mapping customer emails and list details. **Do not modify the payload code**, as doing so may cause the API tracking to fail.
## Turn it on
After pasting your token into the header field, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist creation activity and passing it over to Attentive.
Create a new wishlist on your storefront using a test account. Check your Shopify Flow run history to confirm that the HTTP status returns a successful response code.
Events can take up to 1 hour to fully process and appear in your Attentive dashboard after Shopify sends them. If you do not see the custom event in Attentive immediately during testing, allow up to 60 minutes for the pipeline to update.
## What this workflow does
Once enabled, the workflow watches for shoppers who create a brand new wishlist in Wysh. It instantly packages the shopper's contact profile and list data, and runs an internal HTTP Post request that transmits the event directly to the Attentive Custom Events API. This provides your text message marketing engine with a strong baseline event to welcome subscribers or segment lists based on early intent.
---
### Hide the Wysh icon
**URL:** https://wysh.mantledocs.com/hide-the-wysh-icon
## Control where the Wysh icon appears
You can hide the Wysh wishlist icon in specific areas of your storefront from your Shopify theme editor. These options are available in the **App embeds** settings for **Wysh**, under **Wishlist visibility**.
These settings let you turn off Wysh in specific locations without editing your theme code.
## Open the Wishlist visibility settings
In Shopify admin, go to **Online Store**.
On your live theme, click **Edit Theme**.
In the theme editor, click the **App embeds** icon in the top-left corner. It is the fourth icon across.
Find **Wysh** in the App embeds panel and click the down arrow to expand its settings.
Scroll to the section called **Wishlist visibility**. This section contains the toggle options for hiding the Wysh icon in different parts of your storefront.
## Available visibility options
In **Wishlist visibility**, enable the options you want to use:
- **Disable header wishlist badge** — Hides the automatically injected wishlist badge in the theme header.
- **Disable wishlist on Homepage** — Hides wishlist icons on featured product grids on the homepage.
- **Disable wishlist on Collection Page** — Hides wishlist icons on collection listing pages.
- **Disable wishlist on Search** — Hides wishlist icons on search result pages.
- **Disable wishlist on Product page** — Hides the main **Add to wishlist** button on product detail pages.
- **Disable wishlist on related products** — Hides wishlist icons on related, complementary, and recently viewed product sections on product pages.
## Save your changes
After selecting the options you want, click **Save** in the theme editor to make the changes live on your theme.
If you only want to remove Wysh from certain parts of the storefront, leave the other visibility options turned off so customers can still use wishlist features elsewhere.
## What each setting affects
This controls the wishlist badge that Wysh injects into the theme header. Turn it off if you do not want customers to open **My Wishlist** from the header area.
These settings remove wishlist icons from product cards shown on the homepage and collection pages. This is useful if you want a cleaner browsing experience while keeping wishlist actions on product pages.
This removes wishlist icons from products shown on storefront search results pages.
This hides the main **Add to wishlist** button that appears alongside the main purchase actions on the product page.
This removes wishlist icons from related, complementary, and recently viewed product sections that appear below or around the main product content.
## Notes
These settings affect the theme where you make the change in Shopify's theme editor. If you are working on an unpublished theme, the changes will apply there until that theme is published.
If your store uses manual icon placement for unsupported or partially supported themes, theme code and visibility settings may both affect where wishlist buttons appear.
---
### Attentive Automations
**URL:** https://wysh.mantledocs.com/attentive-automations
Drive high-impact revenue and urgent text engagement by linking your Wysh storefront activity directly with Attentive's custom SMS subscriber journeys.
Once active inside Shopify Flow, high-intent wishlist behavioral data routes securely via custom API payloads straight over to your marketing dashboard, allowing you to trigger hyper-targeted text messages the moment items drop in stock, fall below threshold minimums, or sit forgotten in active customer lists.
## Available Templates
Browse and install our pre-built Shopify Flow templates for Attentive:
- **[New Wishlist Created](/features/send-wishlist-created-event-to-attentive):** Kick off initial SMS welcome tracks tailored specifically for active wishlist subscribers.
- **[Item Added to Wishlist](/features/send-wishlist-item-added-event-to-attentive):** Capture real-time buyer intent strings to create foundational behavioral tracking hooks.
- **[Item Removed from Wishlist](/features/send-wishlist-item-removed-event-to-attentive):** Log consumer preference shifts and keep profile metrics clean when users drop items.
- **[Wishlist Reminder](/features/send-wishlist-reminder-event-to-attentive):** Queue a 2-day countdown block to text shoppers about products remaining on their saved lists.
- **[Back in Stock Alert](/features/send-wishlist-item-back-in-stock-event-to-attentive):** Recover lost revenue by messaging subscribers the second an out-of-stock item returns to shelves.
- **[Low Stock Alert](/features/send-wishlist-item-low-stock-event-to-attentive):** Capitalize on immediate urgency by texting shoppers when an item on their wishlist drops to 2 units or fewer.
---
### View customer wishlists
**URL:** https://wysh.mantledocs.com/see-customers-wishlist-favourites
Wysh now makes it easier for staff to view customer wishlist favourites directly in the app. Instead of asking customers to share their wishlist by email, you can go to the **Wishlists** page, find the customer, and open their wishlist to see the items they have saved.
This is useful when you want a quick view of what a customer is interested in so you can give better recommendations, prepare a quote, or support an assisted sale.
## When to use this feature
- When a customer wants recommendations based on products they already like
- When you need to check saved items before suggesting sizes, colours, or similar products
- When you are preparing a quote or helping build an order
- When a customer is shopping in-store, by phone, or through customer service
## How to view a customer’s wishlist
In the Wysh app, go to **Wishlists**. This page shows a list of customer wishlists that staff can browse. Look through the list to find the customer whose wishlist you want to view. Click the **customer name** to open that customer’s wishlist. View the products saved in the wishlist and use them to guide your conversation, recommendations, quote, or assisted sale. You no longer need to ask customers to share their wishlist by email in order to view their saved items.
## How staff can use wishlist favourites
A customer’s wishlist gives you a practical starting point for personalised service. The saved items show what the customer is interested in right now, which helps you respond with more relevant suggestions.
- Recommend similar products to the items in the wishlist
- Suggest matching colours, sizes, variants, or complementary items
- Use saved products as a starting point for a quote
- Help the customer compare options without asking them to find each item again
## Tips
Use the wishlist before making recommendations so your suggestions stay close to what the customer has already shown interest in. If the customer has several saved items, scan for patterns such as brand, style, price range, or product type to guide the conversation more quickly. When helping a customer live in-store or over the phone, opening their wishlist can save time and reduce back-and-forth.
## FAQ
No. Staff can now view customer wishlists directly in the Wysh app from the **Wishlists** page. Go to **Wishlists** in Wysh, then click the customer’s name to open their wishlist. You can view the items the customer has saved so you can use them for recommendations, quotes, and assisted sales. Check it whenever you need to understand the customer’s preferences quickly, especially before suggesting products or preparing a quote.
---
### Ometria Automations
**URL:** https://wysh.mantledocs.com/ometria-automations
# Ometria Automations
Unify customer data and drive high-performance lifecycle marketing by linking your Wysh storefront activity directly with Ometria's retail-focused customer data platform (CDP).
Once active inside Shopify Flow, real-time wishlist data routes securely via custom API payloads straight over to your dashboard. This enables your team to construct AI-driven cross-channel segments and trigger highly personalized emails or push notifications the moment saved items go on sale, run low, or sit waiting in active customer collections.
## Available Templates
Browse and install our pre-built Shopify Flow templates for Ometria:
- **[New Wishlist Created](/features/send-wishlist-created-event-to-ometria):** Introduce shoppers to your brand lifecycle early with tailored onboarding campaigns when they build their first list.
- **[Item Added to Wishlist](/features/send-wishlist-item-added-event-to-ometria):** Feed immediate interest signals into your Ometria tracking profile to fuel powerful custom browse behavior models.
- **[Item Removed from Wishlist](/features/send-wishlist-item-removed-event-to-ometria):** Automatically refine customer profiles and update active preferences when users clear out items.
- **[Wishlist Reminder](/features/send-wishlist-reminder-event-to-ometria):** Schedule automated touchpoints to gently prompt shoppers to re-evaluate the products left sitting in their wishlists.
- **[Back in Stock Alert](/features/send-wishlist-item-back-in-stock-event-to-ometria):** Capture immediate recovery revenue by messaging subscribers the second an out-of-stock item is replenished.
- **[Low Stock Alert](/features/send-wishlist-item-low-stock-event-to-ometria):** Use predictive urgency markers to message shoppers when an item on their wishlist falls to critical stock levels.
---
### Send Wishlist Item Added Event to Klaviyo
**URL:** https://wysh.mantledocs.com/send-wishlist-item-added-event-to-klaviyo
Use this Shopify Flow template to send a Klaviyo event after a shopper adds an item to their wishlist in Wysh. By default, the event is sent immediately, making it easy to track real-time customer behavior, build rich behavioral segments, or trigger instantaneous automated marketing actions based on current shopper interest.
You can customize the workflow in Shopify Flow to match your specific marketing or segmenting strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Klaviyo** must be set up, and you will need your **Klaviyo Public API Key** to finish the workflow configuration.
The template sends a Klaviyo event for wishlist item additions. Once the event is being sent successfully, you can use it in Klaviyo to capture real-time intent data and update targeted customer segments.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/18f5d9df-2b5f-4b7b-b499-53cfaefcf837/wysh_klaviyo_wishlist_item_added.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item addition trigger and the Klaviyo event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Add your Klaviyo Public API Key:** Replace the placeholder value in the Klaviyo step with the Public API Key from your Klaviyo account.
- **Confirm the event name:** The default event name is `Item added to wishlist`. Keep it as-is or rename it if you want to organize events differently in Klaviyo.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Klaviyo for your setup.
- **Adjust timing if needed:** By default, this event is sent immediately. If you want to introduce a delay or a wait period, you can add a wait step in Shopify Flow and set it to seconds, minutes, hours, days, or weeks.
Tracking addition behavior immediately allows you to build powerful browse-abandonment segments or score leads based on how frequently a shopper adds items to their wishlist.
## Turn it on
After updating the API key and any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist addition activity from Wysh.
Add an item to a wishlist on your storefront as a test shopper, then confirm the workflow runs as expected and the event appears in Klaviyo.
If the workflow is not turned on, no Klaviyo events will be sent when products are added to a wishlist.
## What this workflow does
Once enabled, the workflow watches for shoppers who add items to their wishlist in Wysh. It immediately sends a Klaviyo event with details about the shopper and the added product. You can then use that event in Klaviyo to capture instant shopper intent, build precise segments, or power your own custom automation flows.
---
### Send Wishlist Item Low Stock Event to Attentive
**URL:** https://wysh.mantledocs.com/send-wishlist-item-low-stock-event-to-attentive
Use this Shopify Flow template to automatically fire an event to Attentive whenever a product variant on a shopper's wishlist falls below a safe inventory threshold. When an item's stock drops to **2 units or fewer** by default, this workflow instantly cross-references your active Wysh wishlist data to find every subscriber who has saved it, executing an HTTP request for each matching profile.
The data payload is completely pre-populated with customer and variant variables, giving you an immediate hook to trigger high-conversion urgency SMS notifications.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **An Attentive account** with administrator privileges is required to generate custom app credentials.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock drops.
This template relies on a custom API connection rather than a native app block. Once configured, it pairs your real-time inventory level dips with subscriber intent data to create an automated low-stock text message trigger.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/e6c83902-4ad8-4741-bed4-a54028fc9bf7/wysh_attentive_wishlist_item_low_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory trigger, the stock condition check, the Wysh loop block, and the **Send HTTP request** action.
## Customize the workflow
Because this workflow bridges systems using a custom API connection, you must add your Attentive security token to the request headers before activating it.
### 1. Generate your Attentive API Token
1. Log in to your **Attentive dashboard** and navigate to your integration/developer settings.
2. Create a new **Custom App**.
3. During setup, ensure you grant **Write** access permissions to **Custom Events**.
4. Generate the app and copy the provided API key/token to your clipboard.
### 2. Update the Shopify Flow Settings
- **Adjust the stock threshold:** The workflow triggers when product inventory is **less than or equal to 2** by default. You can change this number in the condition block to any minimum threshold that matches your fulfillment speeds.
- **Update the HTTP Header:** Open the **Send HTTP request** step located inside the loop block of the imported workflow. Locate the **Headers** section, find the field containing the word `Bearer`, and paste your copied Attentive token directly into the **Value** field right after the word `Bearer` (leave a single space between "Bearer" and your token string, e.g., `Bearer your_token_here`).
> **Important:** The request body and data payload are already fully configured and pre-populated with correct template variables mapping customer profiles and low-stock items. **Do not modify the payload code**, as doing so may cause the API tracking to fail.
## Turn it on
After verifying your stock thresholds and pasting your token into the header field, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring inventory levels and matching low-stock items against customer wishlists.
Find a product currently saved to a test customer's wishlist, manually lower its inventory count to 2 or fewer in your Shopify admin, and confirm the workflow loops through and triggers the HTTP request successfully.
Events can take up to 1 hour to fully process and appear in your Attentive dashboard after Shopify sends them. If you do not see the custom event in Attentive immediately during testing, allow up to 60 minutes for the pipeline to update.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where stock levels drop down to your chosen minimum (default is 2). When this threshold is crossed, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, running an internal HTTP Post request that transmits the event directly to the Attentive Custom Events API for each subscriber—giving your text engine the precise trigger needed to power automated "Wishlist Item Low Stock" urgency tracks.
---
### Add to Wishlist Button theme block
**URL:** https://wysh.mantledocs.com/add-to-wishlist-button-block
## Add the wishlist button where you want it
Wysh now includes a theme block called **Add to Wishlist Button**. This lets you place the wishlist button or icon in a specific spot on your product page instead of relying on the default placement.
You add the block directly in the Shopify theme editor, then use the block settings to control the button’s display, colours, text, and spacing.
When this block is present, Wysh disables automatic injection of the wishlist button on that product page template. This allows the block placement you choose to take priority.
## Where to find the block
In the Shopify theme editor, open a product page template and add the block in the section where you want the wishlist button to appear.
In Shopify, go to your **theme editor** and navigate to a product page template. In the left sidebar, find the product section where you want the wishlist button to show. In the example shown, the block is added within **Product information**. Select **Add block** in the position where you want the button or icon to appear. In the block picker, select the **Apps** tab. Choose **Add to Wishlist Button** from Wysh. If you want the wishlist button beside product details, under the buy buttons, or in another custom position, add the block in that exact part of the product page layout.
## Customise the block
After adding the block, click **Add to Wishlist Button** in the theme editor sidebar to open its settings.
The block includes the following customisation options:
### Button content
- **Add button text** — sets the text shown before an item is saved, such as `Add to Wishlist`.
- **Remove button text** — sets the text shown after an item has been saved, such as `Remove from Wishlist`.
- **Button style** — controls how the button is displayed, for example **Icon and text**.
### Default state
- **Background color**
- **Text and icon color**
- **Border color**
### Hover state
- **Hover background color**
- **Hover text and icon color**
- **Hover border color**
These settings let you match the button to your theme styling while keeping the wishlist action visible on the product page.
## Adjust shape and spacing
You can also control the button’s shape and the spacing around it.
- **Border thickness** — controls the width of the button border.
- **Border radius** — controls how rounded the corners are.
- **Margin top** — adds space above the block.
- **Margin bottom** — adds space below the block.
These options are useful when you need the wishlist button to sit neatly between existing product page elements.
## Best practices
- Place the block close to key purchase actions so customers can easily save products for later.
- Use **Icon and text** if you want the action to be more obvious to shoppers.
- Match the **Default state** and **Hover state** colours to your theme for a more consistent storefront appearance.
If styling changes do not appear on the storefront, Wysh setup or theme-level styling may be overriding your block settings. In that case, review your existing Wysh theme configuration.
## What this feature is for
Use **Add to Wishlist Button** when you want more control over where the wishlist action appears on the product page. It is especially helpful if your theme layout needs the button in a specific content area rather than in the app’s default location.
---
### Use Wysh with Sidekick
**URL:** https://wysh.mantledocs.com/use-wysh-with-sidekick
## Ask Sidekick about your Wysh data
Wysh now works with **Sidekick**, Shopify’s built-in AI assistant. You can use it to ask questions about your Wysh data in plain language instead of manually checking the **Dashboard** or the **Wishlists** page.
This makes it faster to look up customer wishlists, review wishlist performance, spot product demand, and understand recent wishlist activity across both your online store and Shopify POS.
This feature works in all supported languages.
## Where to find it
In the Wysh **Dashboard**, you will see a block titled **Ask Sidekick anything about Wysh**. This block shows example questions you can use right away.
To open Sidekick, click the small **Sidekick** icon in the Shopify admin header bar, next to the alerts or notification bell.
## How the dashboard block works
Each suggestion in the **Ask Sidekick anything about Wysh** block includes a copy icon.
- Clicking a suggestion copies that question to your clipboard
- Wysh then prompts you to open Sidekick
- Paste the copied question into Sidekick to run it
If you do not want to type your own question from scratch, start with one of the suggestions in the dashboard block, then edit the wording in Sidekick before sending it.
## How to use Sidekick with Wysh
In Wysh, go to **Dashboard**.
Use one of the suggestions in the **Ask Sidekick anything about Wysh** block, or prepare your own question based on the examples below.
Click the **Sidekick** icon in the Shopify admin header.
Paste the question into Sidekick and send it. Sidekick will return results using your Wysh data.
## What you can ask
### Wishlist lookup
Use Sidekick when you want to find a specific wishlist or understand what a customer has saved. For example:
- `Find wishlists for customer jane@example.com`
- `Show me wishlist #42`
- `What products are on that wishlist?`
- `Show me all wishlists for customer 12345`
This is especially useful if you already use the **Wishlists** page to review saved items and want a faster way to find the right list.
Wysh supports both customer wishlists and guest wishlists. Guest wishlists will not include a customer name or email address.
### Performance and analytics
Use Sidekick to ask the same kinds of questions you might normally investigate through the Wysh **Dashboard**, including metrics related to **Wishlist Revenue**, **Top Wishlisted Products**, and the **Wishlist activity feed**. For example:
- `How much revenue is Wysh driving?`
- `Which products are trending right now?`
- `What percentage of wishlist items convert to sales?`
- `How is Product X performing on wishlists?`
- `How does wishlist revenue compare between online and POS?`
- `What's the latest wishlist activity?`
### Inventory and demand
Use Sidekick to spot demand signals and possible stock issues. For example:
- `Are any products wishlisted more than we have in stock?`
- `Who's waiting for the Blue / Large variant?`
These questions can help you identify strong interest before a sale happens, especially for products that appear often in wishlist activity.
## Time periods you can use
For analytics questions, you can ask about a specific timeframe. Supported time periods include:
- Last 7 days
- Last 30 days
- Last 60 days
- Last 90 days
- Last 6 months
- Last 12 months
- All time
If you do not mention a timeframe, Wysh uses **the last 30 days** by default.
To get more useful answers, include the timeframe in your question, such as `How much revenue is Wysh driving in the last 90 days?` or `Which products are trending right now in the last 7 days?`
## What results include
- **Revenue figures** are shown in your store’s currency
- **Product results** include links to the relevant Shopify admin product pages
- **Customer results** include links to the relevant Shopify admin customer pages
- Results can include data from both the online storefront and **Shopify POS**
Wysh tracks wishlist activity across both your online store and Shopify POS, so Sidekick answers can reflect both channels where relevant.
## First-time permission prompt
If your store has not used Sidekick to query Wysh before, Sidekick will ask for permission before it can access Wysh data.
This is expected. You can choose any of the available permission options, including:
- Allow once
- Allow and do not ask again
- Do not allow
You only need to grant access before Sidekick can use Wysh data for the first time.
## Best practices
- Use specific product names, customer emails, or wishlist numbers when possible
- Add a timeframe to analytics questions for clearer reporting
- Ask follow-up questions like `What products are on that wishlist?` after opening a specific list
- Use Sidekick for quick answers, then open the **Dashboard** or **Wishlists** page in Wysh when you want to review more detail manually
## Example questions to copy
- `Find wishlists for customer jane@example.com`
- `Show me all wishlists for customer 12345`
- `Show me wishlist #42`
- `What products are on that wishlist?`
- `How much revenue is Wysh driving in the last 30 days?`
- `What percentage of wishlist items convert to sales in the last 90 days?`
- `How does wishlist revenue compare between online and POS in the last 12 months?`
- `Which products are trending right now?`
- `How is Product X performing on wishlists in the last 60 days?`
- `Are any products wishlisted more than we have in stock?`
- `Who's waiting for the Blue / Large variant?`
- `What's the latest wishlist activity?`
- `What has happened in wishlists in the last 7 days?`
---
### How to enable and customise a floating wishlist badge
**URL:** https://wysh.mantledocs.com/how-to-enable-and-customise-a-floating-wishlist-badge
## Enable the floating wishlist badge
The **Header/floating wishlist badge** settings let you show a fixed wishlist button on the screen instead of placing the wishlist badge inside your header. This is useful if you want the wishlist shortcut to stay visible as shoppers move around your store, and also if you'd like to move away from the standard injection method for the badge within the header.
When **Enable floating wishlist badge** is turned on, the app shows a floating badge and automatically disables header badge injection.
Go to the **Header/floating wishlist badge** section in the theme editor by opening the app embed section and expanding Wysh.
Enable the **Enable floating wishlist badge** toggle.
Use the **Position** dropdown to place the badge, for example **Bottom Right**.
Check the badge on your live theme or preview theme to make sure the position and styling fit your layout.
Enabling the floating badge replaces the header-injected wishlist badge. You do not need to configure both at the same time.
## Choose the badge position
Use the **Position** dropdown to decide where the floating badge appears on the screen. The selected position acts as the starting anchor point for the badge.
For example, if you choose **Bottom Right**, the badge will sit in the lower-right area of the screen. You can then fine-tune that placement with the offset controls.
### Adjust horizontal offset
The **Horizontal offset** setting changes the badge position from side to side.
- For default edge positions, a value closer to **0 px** keeps the badge closer to the screen edge.
- A higher value moves it further inward.
Use this when the badge feels too close to the screen edge or overlaps with other fixed elements.
### Adjust vertical offset
The **Vertical offset** setting changes the badge position up or down.
- For bottom positions, negative values move the badge closer to the bottom edge and positive values move it upward or downward depending on the selected anchor.
- The helper text in the app explains how the value behaves for middle positions.
This is especially helpful if your theme has sticky elements, chat widgets, cookie bars, or other floating tools near the same area.
After changing offsets, preview the badge on both desktop and mobile. A position that works well on desktop may sit too close to another floating element on smaller screens.
## Customise the floating icon
You can control the size, shape, and colours of the floating wishlist button so it matches your storefront branding.
### Change icon size
Use **Icon size** to change the overall size of the floating icon. The circular background scales proportionally with the icon size, so increasing this setting makes the entire floating button appear larger.
### Set the border radius
Use **Border radius** to control how rounded the floating badge background is.
- **50%** creates a circle.
- **0%** creates a square.
- Values in between create rounded corners.
This is the main control for changing the badge from a fully circular button to a softer rounded shape.
### Change the default icon and background colours
Use these colour pickers to style the floating button in its normal state:
- **Icon colour** controls the wishlist icon colour.
- **Background colour** controls the button background behind the icon.
If you want a high-contrast floating button, choose clearly different values for the icon and background colours.
### Change hover colours
You can also style the hover state using:
- **Icon hover colour**
- **Background hover colour**
These settings control how the badge looks when a shopper hovers over it on desktop. This is useful for adding stronger visual feedback and making the button feel more interactive.
Hover colour settings mainly affect desktop behaviour. On touch devices, shoppers usually see the default state instead of a hover state.
## Recommended styling tips
- Use a badge position that does not overlap with chat widgets, cookie banners, or mobile sticky buttons.
- Keep strong contrast between **Icon colour** and **Background colour** for accessibility.
- If you use a count badge, make sure the **Count badge text colour** is easy to read against the chosen background.
- Match the **Border radius** to your theme style: circular for softer modern layouts, or lower radius values for sharper UI styles.
- Test the hover state colours to ensure the badge still looks branded and readable when shoppers interact with it.
If your floating badge is too close to the edge or overlaps another fixed element, adjust the horizontal and vertical offsets before changing icon size. Position issues are usually easier to solve with offsets first.
## What to check after setup
Once your floating wishlist badge is enabled and styled, confirm the following on your storefront:
- The badge appears in the selected **Position**.
- The **Horizontal offset** and **Vertical offset** place it correctly on desktop and mobile.
- The icon is large enough to tap comfortably.
- The normal and hover colours match your brand.
- If enabled, the item count bubble is readable and does not sit too far away from the icon.
With these settings, you can create a floating wishlist shortcut that stays visible, fits your theme design, and gives shoppers a clear view of their saved items.
---
### How to show and customise the item count on the wishlist badge
**URL:** https://wysh.mantledocs.com/how-to-customise-the-item-count-on-the-wishlist-badge
## Show the item count on the wishlist badge
You can display a small count bubble on the wishlist badge so shoppers can quickly see how many items they have saved.
In the app embed settings, this option appears as **Show item count on the wishlist badge**. When enabled, the app displays a count bubble showing the total number of wishlisted items.
In Shopify, open your theme editor, go to the app embed section, and expand **Wysh**. Then open the **Header/floating wishlist badge** settings.
Enable the **Show item count on the wishlist badge** toggle.
Use the count badge settings to control the badge position, size, font, width, border, and colours.
Check the badge on your storefront to make sure the count is readable and positioned correctly on both desktop and mobile.
The count bubble appears on the wishlist badge and updates to reflect the shopper's saved items.
## Move the count badge into place
Once the item count is enabled, you can fine-tune where the count bubble sits on the wishlist badge using the offset controls.
### Count badge vertical offset
Use **Count badge vertical offset** to move the count bubble up or down. This is useful if the bubble sits too high, too low, or feels too detached from the wishlist icon.
- Lower values keep the bubble closer to its default position.
- Higher or lower adjustments can help it sit more neatly against the badge, depending on your layout.
### Count badge horizontal offset
Use **Count badge horizontal offset** to move the count bubble left or right. Adjust this if the badge feels too close to the edge of the icon or if it overlaps another part of the badge design.
Make small offset changes and preview after each one. A subtle position change often looks better than a large jump.
## Change the count badge size and text styling
The app includes separate controls for the size of the bubble and the text inside it, so you can balance visibility with the overall badge design.
### Count badge size
**Count badge size** changes the overall size of the count bubble. Increase this if you want the item count to stand out more, or reduce it if the badge feels too prominent.
### Count badge font size
**Count badge font size** controls the size of the number shown inside the bubble. If the number looks cramped or too small to read, increase the font size until it feels clear without overpowering the badge.
### Count badge width
Use **Count badge width** to control how wide the badge is. This is especially helpful if you want a more rounded pill shape or need more room for larger numbers.
A wider badge can improve readability when shoppers save multiple items.
### Count badge border width
**Count badge border width** controls the thickness of the badge outline. A stronger border can help the count bubble stand out against busy backgrounds or similarly coloured badge icons.
If your count badge looks crowded, adjust **Count badge size**, **Count badge font size**, and **Count badge width** together rather than changing only one setting.
## Change the count badge colours
You can customise the item count colours to match your brand and keep the badge easy to read.
### Count badge background colour
**Count badge background colour** sets the fill colour of the count bubble itself. Choose a colour that stands out clearly against the wishlist badge.
### Count badge text colour
**Count badge text colour** changes the colour of the number shown inside the bubble. Use a high-contrast colour so the item count stays readable at a glance.
### Count badge border colour
**Count badge border colour** controls the outline colour around the badge. This can help separate the count bubble from the icon underneath, especially if the background colours are similar.
Avoid using similar colours for the badge background and text. Low contrast can make the item count difficult to read, especially on smaller screens.
## Recommended styling tips
- Keep the count bubble close to the wishlist badge by starting with the offset controls first.
- Use enough contrast between **Count badge background colour** and **Count badge text colour**.
- Increase **Count badge width** if double-digit counts feel cramped.
- Use **Count badge border colour** and **Count badge border width** if the bubble blends into the badge behind it.
- Preview your settings on mobile as well as desktop to make sure the count remains clear and balanced.
## What to check after setup
After enabling and styling the count bubble, confirm the following on your storefront:
- The **Show item count on the wishlist badge** toggle is enabled.
- The count bubble is aligned correctly using **Count badge vertical offset** and **Count badge horizontal offset**.
- The bubble is large enough to read with your chosen **Count badge size** and **Count badge font size**.
- The selected **Count badge width** gives the number enough space.
- The colours and border settings make the count stand out clearly against the wishlist badge.
With these settings, you can make the wishlist item count visible, easy to read, and consistent with the rest of your store design.
---
### How to sync wishlists with POS
**URL:** https://wysh.mantledocs.com/use-wishlists-for-pos-requests
## Use wishlists in your POS workflow
Wysh does not add a separate request button to the wishlist page. Instead, customers use the built-in **Share Wishlist** button on the **My Wishlist** page to send their saved items to your store. Your team can then use that shared list as the starting point for an in-store, POS, or quote conversation.
This workflow is based on the storefront wishlist page. The customer-facing labels shown there include **My Wishlist**, **Share Wishlist**, **+ Create New List**, and product-level **Add to cart** buttons.
## When to use this workflow
- When a customer wants help buying wishlist items in-store
- When staff need a simple way to review saved products before creating an order in POS
- When you want customers to send a wishlist for a manual quote or assisted sale
## How customers share their wishlist
Ask the customer to open the storefront wishlist page. The page title shown is **My Wishlist**.
On the wishlist page, the customer can see their saved products, item count, prices, and an **Add to cart** button under each product.
On the right side of the page, select **Share Wishlist**.
The customer sends the shared wishlist to your store’s email address. Your team can then open the email, review the saved items, and continue the sale in your normal POS process.
For the smoothest handoff, give customers one email address to use for shared wishlists, such as your sales inbox or a dedicated quote inbox.
## How staff can use the shared wishlist in POS
1. Open the customer’s shared wishlist email.
2. Review the products the customer saved from **My Wishlist**.
3. Confirm any details that are not included automatically, such as quantity, size, color, personalization, or delivery timing.
4. Add the matching products to the order in your POS system.
5. Complete the sale, save a draft order, or reply with a quote, depending on your store’s process.
The app’s wishlist page helps customers save and share products. Staff still complete the final sale in their usual POS workflow.
## What to ask the customer before you build the order
- The exact quantity needed for each item
- Any variant choices, such as size or color
- Personalization or custom details
- Needed-by date
- Pickup or delivery preference
## What the other wishlist buttons do
- **Share Wishlist**: sends the wishlist so your store can review it
- **+ Create New List**: creates another wishlist for the customer
- **Add to cart**: moves an individual saved item toward checkout
**+ Create New List** and **Add to cart** do not send the wishlist to your team. If the customer wants store assistance, make sure they use **Share Wishlist**.
## Best practices for a smoother POS handoff
- Tell customers exactly where to send their shared wishlist
- Ask them to include their name and contact details in the email
- Have staff confirm variants and quantities before building the order
- Use the shared wishlist as the reference list for assisted selling, not as a final confirmed order
## FAQ
No. The current wishlist workflow uses **Share Wishlist** as the handoff method.
Yes. Each saved product can show an **Add to cart** button so the customer can purchase items without staff help.
This workflow is designed as a share-and-review process. Your team reviews the shared wishlist, then completes the order in your usual POS flow.
---
### Change the wishlist icon
**URL:** https://wysh.mantledocs.com/change-the-wishlist-icon
## Change the icon used by Wysh
You can change the icon Wysh uses across your storefront from the Shopify theme editor. This setting is found in the **Wysh Wishlist** app embed, inside the **Header/floating wishlist badge** section.
The **Wishlist icon** setting controls the icon shown wherever the Wysh icon appears, including the header badge or floating badge depending on how your store is configured.
## Open the Wishlist icon setting
In Shopify admin, go to **Online Store**.
On your theme, click **Edit Theme**.
In the theme editor, click the **App embeds** icon in the top-left corner.
Find **Wysh Wishlist** and expand it to open its settings.
Scroll to the **Header/floating wishlist badge** section. Find the **Wishlist icon** dropdown.
Select the icon style you want to use: **Heart**, **Star**, **Bookmark**, **Gift**, or **Custom**.
Click **Save** in the theme editor. The selected icon will then be used wherever the Wysh icon appears on your storefront.
## Available icon options
The **Wishlist icon** dropdown includes five options:
- **Heart**
- **Star**
- **Bookmark**
- **Gift**
- **Custom**
If you choose **Heart**, **Star**, **Bookmark**, or **Gift**, Wysh updates the icon automatically everywhere that icon is displayed in your theme.
## Use a custom icon
If you want to use your own design instead of one of the built-in icon styles, choose **Custom** in the **Wishlist icon** dropdown.
When **Custom** is selected, two extra upload fields appear:
- **Empty icon**
- **Filled icon**
Upload both versions, then save the theme editor. Once saved, your custom icon will appear wherever the Wysh icon is used on your storefront.
To use **Custom**, upload both an **Empty icon** and a **Filled icon**. If one is missing, Wysh falls back to the default heart icon.
## When this change applies
The icon choice applies at the theme level in the Shopify theme editor. After saving, the new icon is used wherever the Wysh icon appears in that theme.
## What to check after saving
- The new icon appears in the expected places on your storefront.
- Your custom uploads, if used, display correctly in both empty and filled states.
- The icon is clear and readable on both desktop and mobile.
If you are using a custom icon, use simple artwork with a transparent background so it fits neatly across different parts of your theme.
---
### Track wishlist performance
**URL:** https://wysh.mantledocs.com/track-wishlist-performance
## Use Wysh to measure wishlist demand
Wysh helps you understand what shoppers want before they buy. In the **Wysh Dashboard**, you can track wishlist activity from one place and use the widgets to see how interest turns into purchases and revenue.
Your wishlist reporting is driven by customer actions already visible in your storefront, including **My Wishlist**, **My Lists**, **Create New List**, **Share Wishlist**, and **Add to cart**.
When a customer saves a product from a product page using the wishlist control beside **Add to cart** and **Buy it now**, that activity contributes to your wishlist reporting. If multiple lists are enabled, the same action can happen through the product-page wishlist control with its list selector, and the saved items are then managed under **My Lists**.
The metrics on the dashboard are best read as a funnel: customers create lists, save items, buy from those saved items, and then generate wishlist-attributed revenue.
## Find wishlist data in the new dashboard
The new Wysh dashboard brings wishlist reporting together into a set of widgets so you can review performance at a glance.
Go to the **Dashboard** in Wysh.
Use the dashboard filters on the widgets to view data for one of these ranges:
- Last 7 days
- Last 30 days
- Last 90 days
- Last 6 months
- Last 12 months
- All
Use the dashboard widgets to compare list creation, saved items, purchases, revenue, top wishlisted products, and recent wishlist activity for the same date range.
The date range you select changes the data shown in the dashboard widgets, so make sure you are comparing metrics from the same period.
## What each dashboard metric means
### Wishlists Created
This shows how many wishlists customers created in Wysh. A new list is created when a customer uses **Create New List** from the wishlist area. If a shopper only has one list, the storefront label is **My Wishlist**. After they create more than one, that area changes to **My Lists**.
Use this metric to understand how many customers are actively organising products for later. A higher number usually means stronger shopper intent, especially for stores where people compare options before buying.
### Items Added to Wishlists
This shows how many products customers have saved across their wishlists. These items come from the wishlist action on the product page, shown beside **Add to cart** and **Buy it now**.
If this number is growing faster than purchases, customers may be interested but still deciding. That often means your products are getting attention, even if sales happen later.
### Purchased from Wishlists
This shows how many wishlist-saved items were later purchased. In practical terms, this is the number of items that moved from a saved state in **My Wishlist** or **My Lists** into an actual order.
This is one of the clearest signals that Wysh is influencing conversions. If customers frequently purchase items they first saved, your wishlist experience is helping move shoppers toward checkout.
### Wishlist Revenue
This shows the revenue generated from items that were previously saved to a wishlist and later purchased.
Use this metric to understand the sales value influenced by wishlist activity, not just the number of items sold. This is especially useful when you want to measure how much wishlist behaviour contributes to overall store revenue.
### Wishlist Revenue
The **Wishlist revenue** widget works with a graph breakdown just below the main widgets, so you can see how wishlist-attributed revenue changes over time within the selected date range, as well as seeing revenue for the selected time period from all wishlists.
Use the graph to spot patterns such as:
- Revenue spikes after promotions or campaigns
- Steady growth in wishlist-driven sales over time
- Periods where customers are saving products but not yet converting
This view is useful when you want more context than a single total revenue number.
### Top Wishlisted Products
This widget highlights the products that customers save most often.
Use it to identify which products generate the strongest interest, even before they become top sellers. A product appearing high in this widget can signal demand, buying intent, or strong appeal during comparison shopping.
This is especially helpful for:
- Spotting products customers want most
- Comparing interest against actual sales performance
- Planning promotions, merchandising, or restocks
### Wishlist activity feed
The **Wishlist activity feed** shows recent wishlist-related actions happening in your store.
Depending on customer activity, this can help you monitor how shoppers are interacting with wishlists in real time, such as creating lists, saving items, and moving from saved products toward purchase.
Use this feed when you want a quick, recent view of engagement rather than a summary total.
## How to read the dashboard as a funnel
The dashboard works best when you read the widgets together rather than in isolation:
- **Wishlists Created** shows how many shoppers are starting to organise products.
- **Items Added to Wishlists** shows how much product interest those shoppers are expressing.
- **Purchased from Wishlists** shows whether that interest turns into orders.
- **Wishlist Revenue** shows the sales value influenced by those purchases.
- **Top Wishlisted Products** shows which products attract the most saving activity.
- **Wishlist activity feed** shows the latest wishlist engagement happening in your store.
If wishlists and saved items are increasing but purchases are not, that often means customers are interested but need more time, better timing, or a stronger reason to buy.
## Use top wishlisted products to spot demand
Top wishlisted products can reveal demand before it appears clearly in sales reports. Customers often save products while comparing options, waiting for payday, planning gifts, or returning later to buy.
Use this widget to answer questions like:
- Which products attract the most shopper interest?
- Which items are frequently saved but not yet purchased?
- Which products may benefit from a promotion or extra visibility?
If a product gets a high number of saves but low purchase activity, that can point to hesitation around price, timing, shipping, or product choice.
## How date ranges help you analyze trends
The dashboard date filters make it easier to compare short-term activity with longer-term behaviour.
- **Last 7 days** helps you monitor recent changes and campaign impact.
- **Last 30 days** gives a useful monthly performance view.
- **Last 90 days** helps you spot medium-term trends.
- **Last 6 months** gives broader context for seasonal behaviour.
- **Last 12 months** helps you review year-long performance patterns.
- **All** shows lifetime wishlist activity available in the dashboard.
When reviewing performance, use the same date range across widgets so your wishlist creation, saved items, purchases, and revenue all reflect the same period.
## What to look for in your results
- If **Wishlists Created** is high, customers are actively planning and saving products for later.
- If **Items Added to Wishlists** is growing, product interest is increasing.
- If **Purchased from Wishlists** is strong, wishlist activity is contributing to conversion.
- If **Wishlist Revenue** is rising, saved items are turning into meaningful sales value.
- If products appear often in **Top Wishlisted Products** but not in sales, those products may need extra attention.
- If the **Wishlist activity feed** stays active, shoppers are consistently engaging with wishlist features.
By using the new dashboard widgets together, you can understand not only what customers save, but also how that interest develops into purchases and revenue over time.
---
### Automations
**URL:** https://wysh.mantledocs.com/automations
Turn your storefront wishlist data into a high-converting retention machine. Wysh integrates directly with **Shopify Flow** to stream real-time shopper intent, stock alerts, and lifecycle milestones straight to your preferred marketing, loyalty, and communication tools.
Select a platform below to learn how it connects to Wysh and to browse ready-to-use automation templates:
- **Klaviyo Automations** **:** Fire highly-targeted email flows for wishlist abandonment, price drops, and restocks.
- **Mailchimp Automations** **:** Automatically tag active contacts and trigger custom buyer journeys based on item activity.
- **Slack Notifications** **:** Send automated channel alerts to track client trends, conversion wins, and storefront activity.
- **LoyaltyLion Rewards** **:** Fuel customer retention by instantly awarding points for wishlist checkout conversions.
- **Attentive Automations** **:** Power high-impact SMS automation journeys via tailored custom API events.
- **Ometria Automations** **:** Unify customer data across your retail CDP and trigger personalized lifecycle, restock, and urgency tracks.
## Connection Frameworks at a Glance
Wysh templates utilize two different methods to sync data through Shopify Flow:
1. **Native Connections:** Seamless app-to-app integrations. Once the app is installed on your Shopify store, Shopify Flow securely maps data behind the scenes without complex tokens.
2. **Custom API Connections (HTTP):** Programmatic bridges that use Shopify Flow's **Send HTTP request** action to send data to apps without native flow triggers. The data payload is 100% pre-coded by Wysh; you just paste your access token into the header.
---
### Send Wishlist Created Event to Mailchimp
**URL:** https://wysh.mantledocs.com/send-wishlist-created-event-to-mailchimp
Use this Shopify Flow template to send an event to Mailchimp after a shopper creates a new wishlist in Wysh. By default, the event is sent immediately, making it easy to trigger a welcoming automated email flow that encourages them to start adding their favorite items.
You can customize the workflow in Shopify Flow to match your specific marketing or segmenting strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Mailchimp** must be connected directly to your Shopify store so Shopify Flow can seamlessly pass data to your Mailchimp account.
The template sends a Mailchimp event for new wishlist creation activity. Once the event is being sent successfully, you can use it in Mailchimp to trigger automated wishlist onboarding journeys or build specialized customer segments.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/e3ab53d6-77aa-4607-a7f4-ee0f73d28338/wysh_mailchimp_created.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the wishlist trigger and the Mailchimp event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Confirm the event name:** The default event name is `New wishlist created`. Keep it as-is or rename it if you want to organize events differently in Mailchimp.
- **Review the event details:** Make sure the event includes the shopper information you want available in Mailchimp for your email setups and audience tagging.
- **Adjust timing if needed:** By default, this event is sent immediately. If you want to introduce a delay, you can add a wait step in Shopify Flow and set it to seconds, minutes, hours, days, or weeks.
Because Mailchimp connects directly to your store, there is no need to hunt for API keys. Just make sure the Mailchimp app is properly integrated with your Shopify admin before turning the workflow on.
## Turn it on
After updating any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for new wishlist creation activity from Wysh.
Create a new wishlist on your storefront as a test shopper, then confirm the workflow runs as expected and the event appears in Mailchimp.
If the workflow is not turned on, no Mailchimp events will be sent and your wishlist welcome journeys will not trigger.
## What this workflow does
Once enabled, the workflow watches for shoppers who create a brand new wishlist in Wysh. It immediately sends a Mailchimp event with details about the shopper and the newly created wishlist. You can then use that event in Mailchimp to power automated wishlist onboarding or engagement emails.
---
### Send Wishlist Item Removed Event to Mailchimp
**URL:** https://wysh.mantledocs.com/send-wishlist-item-removed-event-to-mailchimp
Use this Shopify Flow template to send an event to Mailchimp after a shopper removes an item from their wishlist in Wysh. By default, the event is sent immediately, making it easy to track changes in customer interest or build automation strategies around updated shopper preferences.
You can customize the workflow in Shopify Flow to match your specific marketing or segmenting strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Mailchimp** must be connected directly to your Shopify store so Shopify Flow can seamlessly pass data to your Mailchimp account.
The template sends a Mailchimp event for wishlist item removals. Once the event is being sent successfully, you can use it in Mailchimp to monitor shifts in user intent or update targeted customer segments.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/25a47fab-e470-401a-9d03-284dec4bdb01/wysh_mailchimp_wishlist_item_removed.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item removal trigger and the Mailchimp event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Confirm the event name:** The default event name is `Item removed from wishlist`. Keep it as-is or rename it if you want to organize events differently in Mailchimp.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Mailchimp for your setup and audience fields.
- **Adjust timing if needed:** By default, this event is sent immediately. If you want to introduce a delay, you can add a wait step in Shopify Flow and set it to seconds, minutes, hours, days, or weeks.
Tracking product removals gives you a clear indicator of changes in consumer preference, helping you clean up highly focused preference segments inside Mailchimp.
## Turn it on
After updating any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist removal activity from Wysh.
Remove an item from a wishlist on your storefront as a test shopper, then confirm the workflow runs as expected and the event appears in Mailchimp.
If the workflow is not turned on, no Mailchimp events will be sent when products are removed from a wishlist.
## What this workflow does
Once enabled, the workflow watches for shoppers who remove items from their wishlist in Wysh. It immediately sends a Mailchimp event with details about the shopper and the removed product. You can then use that event in Mailchimp to refine customer profiles, build clean segments, or adjust automated customer journeys based on active intent.
---
### Send Wishlist Item Added Event to Mailchimp
**URL:** https://wysh.mantledocs.com/send-wishlist-item-added-event-to-mailchimp
Use this Shopify Flow template to send an event to Mailchimp after a shopper adds an item to their wishlist in Wysh. By default, the event is sent immediately, making it easy to track real-time customer behavior, build rich behavioral segments, or trigger instantaneous automated marketing actions based on current shopper interest.
You can customize the workflow in Shopify Flow to match your specific marketing or segmenting strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Mailchimp** must be connected directly to your Shopify store so Shopify Flow can seamlessly pass data to your Mailchimp account.
The template sends a Mailchimp event for wishlist item additions. Once the event is being sent successfully, you can use it in Mailchimp to capture real-time intent data and update targeted customer segments.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/85e4fd32-659e-48b3-b623-f7f80b4bad7a/wysh_mailchimp_wishlist_item_added.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item addition trigger and the Mailchimp event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Confirm the event name:** The default event name is `Item added to wishlist`. Keep it as-is or rename it if you want to organize events differently in Mailchimp.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Mailchimp for your setup and audience fields.
- **Adjust timing if needed:** By default, this event is sent immediately. If you want to introduce a delay or a wait period, you can add a wait step in Shopify Flow and set it to seconds, minutes, hours, days, or weeks.
Tracking addition behavior immediately allows you to build powerful browse-abandonment segments or score leads based on how frequently a shopper adds items to their wishlist.
## Turn it on
After updating any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist addition activity from Wysh.
Add an item to a wishlist on your storefront as a test shopper, then confirm the workflow runs as expected and the event appears in Mailchimp.
If the workflow is not turned on, no Mailchimp events will be sent when products are added to a wishlist.
## What this workflow does
Once enabled, the workflow watches for shoppers who add items to their wishlist in Wysh. It immediately sends a Mailchimp event with details about the shopper and the added product. You can then use that event in Mailchimp to capture instant shopper intent, build precise segments, or power your own custom automation flows.
---
### Send Wishlist Item Low Stock Event to Mailchimp
**URL:** https://wysh.mantledocs.com/send-wishlist-item-low-stock-event-to-mailchimp
Use this Shopify Flow template to automatically notify shoppers when an item on their wishlist is running low on stock. When a product's inventory decreases to a defined amount (defaulting to **2 units or fewer**), the workflow automatically checks for any shoppers who have added that specific product to their Wysh wishlist, and instantly sends a Mailchimp event to each of them.
This creates a powerful, high-conversion urgency reminder that encourages shoppers to buy before their favorite items sell out.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Mailchimp** must be connected directly to your Shopify store so Shopify Flow can seamlessly pass data to your Mailchimp account.
- **Inventory tracking** must be enabled for your products within Shopify so Shopify Flow can accurately read stock drops.
The template connects your real-time inventory levels directly with your customer wishlists. Once the low-stock event is being sent successfully, you can use it in Mailchimp to trigger automated Customer Journey maps centered around low-stock urgency.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/e85d51ba-617b-4a38-a605-beddba52a8d9/wysh_mailchimp_wishlist_item_low_stock.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the inventory trigger, the Wysh wishlist loop check, and the Mailchimp event action step.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Adjust the stock threshold:** The workflow triggers when product inventory is **less than or equal to 2** by default. You can change this number in the condition block to any low-stock threshold that matches your inventory speeds.
- **Confirm the event name:** The default event name sent to Mailchimp is `Low stock of wishlist item`. Keep it as-is or rename it to organize events differently in your Mailchimp account.
- **Review customer data payload:** Ensure that the event is correctly passing the shopper's contact details and the specific product variant data so Mailchimp can dynamically populate your email layout.
To maintain a clean user experience, consider setting up entry criteria rules or delays within Mailchimp so a customer doesn't receive multiple low-stock emails on the exact same day if several items drop in inventory at once.
## Turn it on
After adjusting your stock thresholds and verifying your conditions, save the workflow in Shopify Flow.
Turn the workflow on so it can begin monitoring inventory levels and matching low-stock items against customer wishlists.
Find a product currently saved to a test customer's wishlist, manually lower its inventory count to 2 or fewer in your Shopify admin, and confirm the workflow loops through the customers and fires the event to Mailchimp.
If the workflow is not turned on, inventory drops will pass unmonitored, and your high-intent shoppers will miss out on automatic urgency notifications.
## What this workflow does
Once enabled, the workflow watches for an inventory quantity change where stock levels drop down to your chosen minimum (default is 2). When this threshold is crossed, the flow scans active Wysh data to identify every customer who has that exact product saved to a wishlist. It then loops through those customers, sending an individual `Low stock of wishlist item` event to Mailchimp for each one—giving you the precise trigger needed to power automated, high-intent sales recovery journeys.
---
### Send Wishlist Reminder Event to Mailchimp
**URL:** https://wysh.mantledocs.com/send-wishlist-reminder-event-to-mailchimp
Use this Shopify Flow template to send an event to Mailchimp after a shopper adds an item to their wishlist in Wysh. By default, the event is sent **2 days later**, making it easy to build automated wishlist reminder emails that bring shoppers back to complete their purchase.
You can keep the default timing or change the wait period in Shopify Flow to match your reminder strategy.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Mailchimp** must be connected directly to your Shopify store so Shopify Flow can seamlessly pass data to your Mailchimp account.
The template sends a Mailchimp event for wishlist activity after a set delay. Once the event is being sent successfully, you can use it in Mailchimp to trigger automated Customer Journey maps centered around wishlist reminders.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/bfb0493a-f25c-4c27-adc1-24678fe9f7bd/wysh_mailchimp_wishlist_reminder.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the wait step and the Mailchimp event action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Confirm the event name:** The default event name is `Wishlist reminder`. Keep it as-is or rename it if you want to organize events differently in Mailchimp.
- **Review the event details:** Make sure the event includes the shopper and product information you want available in Mailchimp for your email setup.
- **Adjust the wait time if needed:** The workflow waits **2 days** by default before sending the Mailchimp event. You can change this timing in Shopify Flow to seconds, minutes, hours, days, or weeks.
If you want to test different reminder timings, duplicate the workflow and use different wait periods or event names for each version in your Mailchimp audience tracking.
## Turn it on
After updating any workflow settings, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for new wishlist activity from Wysh.
Add an item to a wishlist in your storefront, then confirm the workflow runs as expected and the event appears in Mailchimp after the configured delay.
If the workflow is not turned on, no Mailchimp events will be sent and your automated reminder emails will not trigger.
## What this workflow does
Once enabled, the workflow watches for shoppers who add products to their wishlist in Wysh. After the configured delay, it sends a Mailchimp event with details about the shopper, wishlist, and product. You can then use that event in Mailchimp to power wishlist reminder emails.
---
### Send Slack Message on Wishlist Creation
**URL:** https://wysh.mantledocs.com/send-slack-message-on-wishlist-creation
Use this Shopify Flow template to send a Slack notification automatically whenever a shopper creates a new wishlist in Wysh. By default, the message is sent immediately to your specified channel, providing your team with instant visibility into customer engagement milestones.
You can keep our default message format or completely customize the text and layout to include the specific customer metrics your team tracks.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Slack** must be integrated with your Shopify store, and you must have a specific channel ready (e.g., `#sales-alerts` or `#customer-activity`) where Shopify Flow can post messages.
The template sends a formatted message to Slack for new wishlist activity. Once configured, it helps your team track real-time adoption and storefront trends directly inside your workspace.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/252bc89b-9ec5-426b-a102-1ec81046ad61/wysh_slack_wishlist_created.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the wishlist creation trigger and the Slack message action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Select your Slack channel:** Open the Slack step in the workflow and choose the exact channel where you want this notification to post.
- **Customize the message text:** Review our default message copy. You can edit this text block directly in Shopify Flow to match your team's tone or to add template variables (like the customer's name or wishlist title).
- **Add optional conditions:** If you only want to see alerts for specific groups (like VIP customers or specific tags), you can add an optional condition step right before the Slack action.
Slack allows markdown syntax in its message blocks. You can use asterisks (`*text*`) to make headings bold, or underscores (`_text_`) to italicize information inside your customized message layout.
## Turn it on
After selecting your channel and adjusting your message text, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for new wishlist creation activity from Wysh.
Create a new wishlist on your storefront as a test shopper, then confirm the message posts to your selected Slack channel immediately.
If a valid Slack channel is not specified or the workflow is left turned off, no alerts will be sent to your workspace.
## What this workflow does
Once enabled, the workflow watches for shoppers who create a brand new wishlist in Wysh. It instantly formats a notification containing the activity details and pushes it directly into your designated Slack channel. This keeps your internal team perfectly aligned on active storefront engagement without needing to check your app dashboard.
---
### Send Slack Message on Wishlist Item Purchased
**URL:** https://wysh.mantledocs.com/send-slack-message-on-wishlist-item-purchased
Use this Shopify Flow template to send a Slack notification automatically whenever a shopper purchases an item that was saved on their wishlist in Wysh. By default, the message is sent immediately to your specified channel, giving your marketing and sales teams instant, rewarding visibility into wishlist conversion success.
You can keep our default message format or completely customize the text to celebrate wins or pull in specific order data.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Slack** must be integrated with your Shopify store, and you must have a specific channel ready (e.g., `#sales-wins`, `#wishlist-conversions`, or `#customer-activity`) where Shopify Flow can post messages.
The template sends a formatted notification to Slack when an order includes an item from a shopper's wishlist. Once configured, it helps your team track direct conversion revenue driven by your wishlist strategy.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/627bdce1-ff62-4efb-b600-13a49492c0f7/wysh_slack_wishlist_item_purchased.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the order/purchase trigger, the wishlist verification check, and the Slack message action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Select your Slack channel:** Open the Slack step in the workflow and choose the exact channel where you want these conversion alerts to post.
- **Customize the message text:** Review our default message copy. You can edit this text block directly in Shopify Flow to include template variables, such as the customer's name, the purchased item title, the variant, or the total order value.
- **Add milestone filters:** If you want to limit noise, you can add an optional condition step to only post a Slack message if the total order value exceeds a specific dollar amount.
Try including emojis like :tada: or :moneybag: inside your custom Slack message layout to make conversion milestones stand out visually and boost team morale in your channels!
## Turn it on
After choosing your channel and tailoring the victory message text, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for successful wishlist conversion checkouts.
Place a test order on your storefront using an account that has that product saved to their wishlist, then confirm the message posts to your selected Slack channel immediately.
If a valid Slack channel is not specified or the workflow is left turned off, no conversion alerts will be pushed to your workspace.
## What this workflow does
Once enabled, the workflow watches for completed checkout orders across your storefront. When an order matches a product saved in that customer's Wysh data, it immediately wraps up the conversion data—including shopper info and product context—into a sleek notification block and pushes it to Slack. This keeps your team in loop on high-value, wishlist-driven wins instantly.
---
### Send Slack Message on Wishlist Item Added
**URL:** https://wysh.mantledocs.com/send-slack-message-on-wishlist-item-added
Use this Shopify Flow template to send a Slack notification automatically whenever a shopper adds a new item to their wishlist in Wysh. By default, the message is sent immediately to your specified channel, providing your product, marketing, and inventory teams with real-time insight into which products are capturing customer interest.
You can use our default message layout or completely customize the text to pull in specific product details.
## Before you start
- **Wysh** must be installed and active on your Shopify store.
- **Shopify Flow** must be available on your store so you can import and edit the workflow.
- **Slack** must be integrated with your Shopify store, and you must have a specific channel ready (e.g., `#wishlist-activity` or `#marketing-alerts`) where Shopify Flow can post messages.
The template sends a notification to Slack for wishlist item additions. Once configured, it gives your team an instant pulse on rising trends and customer intent directly inside your daily workspace.
## Install the workflow
Download the template, extract the file, and then import it into Shopify Flow.
[Download Shopify Flow template (.zip)](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/assets/02c27424-795a-457e-88d9-3d68844447a5/wysh_slack_wishlist_item_added.flow.zip)
Download the ZIP folder using the link above, then extract (unzip) it on your computer to get the `.flow` file.
In your Shopify admin, open **Shopify Flow**.
Choose the option to import a workflow, then upload the extracted `.flow` file.
After import, confirm that the workflow includes the item addition trigger and the Slack message action.
## Customize the workflow
After importing the template, review and update the workflow settings before turning it on.
- **Select your Slack channel:** Open the Slack step in the workflow and choose the exact channel where you want these addition alerts to post.
- **Customize the message text:** Review our default message copy. You can change this text block in Shopify Flow to include template variables, such as the shopper's name, the product title, or the variant name.
- **Add conditional steps:** If your channel is getting too noisy, you can add an optional condition step to only send a message for specific high-value collections or when specific tags are attached to the product.
Try customizing the message text to include a direct link to the product variant page in your Shopify admin. This allows your inventory team to instantly check current stock levels whenever an item starts trending on wishlists.
## Turn it on
After choosing your channel and tailoring the notification text, save the workflow in Shopify Flow.
Turn the workflow on so it can start listening for wishlist addition activity from Wysh.
Add an item to a wishlist on your storefront as a test shopper, then confirm the message posts to your chosen Slack channel immediately.
If a valid Slack channel is not specified or the workflow is left disabled, no addition alerts will be pushed to your workspace.
## What this workflow does
Once enabled, the workflow watches for shoppers who add items to their wishlist in Wysh. It immediately packages the activity details—including shopper contact info and specific product details—into a clear notification and pushes it into your designated Slack channel. This keeps your internal teams instantly aligned on customer behavior without requiring them to pull manual reports.
---
## FAQs
### FAQs Overview
**URL:** https://wysh.mantledocs.com/faqs-overview
In this area, you’ll find some commonly asked questions about Wysh functionality and features.
---
### Fully supported themes FAQ
**URL:** https://wysh.mantledocs.com/supported-themes-faq
## Theme support for Wysh
Wysh can auto-inject wishlist icons in many Shopify themes once enabled via the app embed section of the theme editor. If your theme is not on the fully supported list below, you should try [Manual theme icon placement](/getting-started/manual-theme-icon-placement) first.
If you are using an unsupported theme, manual placement is the recommended first step before contacting support.
## Which themes are fully supported right now?
Auto-injection currently works on these themes:
- Atelier
- Be Yours
- Broadcast
- Colorblock
- Concept
- Craft
- Crave
- Dawn
- Dwell
- Enterprise
- Eurus
- Fabric
- Generated Data Theme
- Heritage
- Horizon
- Origin
- Pitch
- Prestige
- Publisher
- Refresh
- Ride
- Rise
- Ritual
- Savor
- Sense
- Skeleton
- Sleek
- Solo
- Spotlight
- Studio
- Taste
- Tinker
- Trade
- Vessel
## What should I do if my theme is not listed?
If your theme is not in the list above, use [Manual theme icon placement](/getting-started/manual-theme-icon-placement) first. This guide shows you how to place the Wysh icon in your theme header, collection product cards, and product page.
The manual placement guide includes the placeholder code and explains where to add it so the icon can appear beside customer-facing actions such as **Add to cart** and **Buy it now**.
## What if manual placement still does not work?
If you have already followed [Manual theme icon placement](/getting-started/manual-theme-icon-placement) and the Wysh icon still does not appear correctly, contact support.
Use **Live Chat Support** from the help center or contact us by email.
Please tell us which Shopify theme you are using. That helps us check whether the theme should auto-inject, whether manual placement is needed, and where the icon should be placed.
Complete the **Theme Configuration** step in the **Setup Guide**, make sure your **storefront embedded app** is enabled, and then follow the [Manual theme icon placement](/getting-started/manual-theme-icon-placement) guide.
## Quick answers
No. If your theme is not fully supported for auto-injection, you can often still use Wysh by following [Manual theme icon placement](/getting-started/manual-theme-icon-placement).
Most stores place the Wysh icon in the header, on collection product cards, and on the product page near **Add to cart** and **Buy it now**.
Theme structure varies from one Shopify theme to another. Sharing your theme name helps us give accurate placement guidance faster.
## Related guide
Follow the manual placement guide if your theme is not on the fully supported list or if auto-injection does not place the icons where you need them.
---
### How to change the colour of the buttons on the wishlist page
**URL:** https://wysh.mantledocs.com/wishlist-page-button-colours-faq
## Change wishlist page button colours
You can change the colours used for the **Add to cart** and **Create New List** buttons on Wysh wishlist pages from your Shopify theme editor.
These settings are found in the **Wysh Wishlist** app embed. If your store was previously styled through the Wysh setup wizard, you must first enable **Override Wizard Settings** before the theme editor button colour settings will take effect.
Enabling **Override Wizard Settings** makes the theme editor settings take priority over styling that was previously set in the Wysh installation wizard.
## FAQ
In Shopify, open your store's theme editor and go to **App embeds**. Then open the **Wysh Wishlist** settings.
Look for **Override Wizard Settings**. If it is not already enabled, turn it on.
This allows the theme editor settings to take precedence over any styling previously set in the Wysh installation wizard.
Scroll down to the **Wishlist pages** section in the Wysh settings.
Find the toggle labelled **Override action button colours** and enable it.
After enabling **Override action button colours**, additional colour fields appear for the wishlist page buttons.
Use these settings to choose the colours for the **primary** and **secondary** action buttons, including their background, text, border, and hover states.
As you update the colours, you can see the changes in real time in the theme editor preview.
When you are happy with the result, click **Save** in the theme editor.
These settings affect the action buttons shown on Wysh wishlist pages, including **Add to cart** and **Create New List**.
Wysh uses separate primary and secondary button colour settings so you can style different button types on the wishlist page.
The most common reason is that **Override Wizard Settings** is still turned off.
If you used custom styling during the Wysh setup wizard, those wizard settings can override theme editor styling until **Override Wizard Settings** is enabled in the **Wysh Wishlist** app embed.
This matches how Wysh handles app-level and theme-level styling: wizard settings win by default, and theme editor settings win only after **Override Wizard Settings** is enabled.
**Override action button colours** enables manual colour selection for wishlist page action buttons.
Once turned on, you can define the colours used for primary and secondary buttons instead of relying on the default wishlist page button styling.
Yes. The Shopify theme editor shows your changes in real time, so you can review the updated **Add to cart** and **Create New List** button colours before saving.
If you want to test design changes first, make them on a draft theme before applying them to your live storefront.
## Quick checklist
- Open **App embeds** in the Shopify theme editor
- Open **Wysh Wishlist**
- Enable **Override Wizard Settings** if needed
- Go to **Wishlist pages**
- Enable **Override action button colours**
- Choose your primary and secondary button colours
- Review the live preview and **Save**
## Related help
Learn why wizard settings can override theme editor styling and how to switch control back to the theme editor. See how Wysh setup works, including the app embed and how theme-level settings relate to wizard settings. Understand how customers use **Create New List** and how wishlist pages change when multiple lists are enabled.
---
### How can I track wishlist performance?
**URL:** https://wysh.mantledocs.com/track-with-dashboard-widgets
## Track wishlist performance at a glance
The **Dashboard** gives you a quick view of how shoppers are using wishlists and whether that interest is turning into sales. Use the date range in the top-right corner, such as **Last 30 days**, to keep all widget data in the same timeframe.
## What to watch
- **Wishlists Created**: how many lists shoppers started.
- **Items Added to Wishlists**: how many products were saved.
- **Purchased From Wishlists**: how many saved items were later bought.
- **Wishlist Revenue**: revenue generated from wishlist-saved items.
- **Top Wishlisted Products**: the products getting the most saves.
- **Wishlist activity**: a recent feed of shopper actions, shown with **Live pulse**.
Read these widgets as a funnel: shoppers create lists, save items, purchase from those saved items, and then generate wishlist revenue.
## Use widgets for tracking
Use **Top Wishlisted Products** to spot demand early, especially for products customers save often but have not purchased yet. Select **View all** to review more product interest beyond the first visible items.
Use **Wishlist activity** when you want a quick read on recent engagement, such as customers adding products to their wishlist.
## Track revenue over time
The **Revenue Breakdown** widget helps you follow wishlist-attributed sales across **Web Revenue**, **POS Revenue**, and **Total Revenue**. Use it to see whether saved products are contributing to revenue over the selected period.
For the clearest comparison, keep the same date range selected while reviewing all widgets.
---
### How do I enable the floating wishlist badge?
**URL:** https://wysh.mantledocs.com/floating-wishlist-badge-faq
## Floating wishlist badge FAQ
In Shopify, open your **theme editor**, go to the **app embed** section, and expand **Wysh**. Open **Header/floating wishlist badge**, then turn on **Enable floating wishlist badge**.
You can then choose a **Position** such as **Bottom Right** and adjust **Horizontal offset** and **Vertical offset** if needed.
Wysh shows a fixed-position wishlist button on the screen and automatically disables **header badge injection**. You do not need to use both at the same time.
If your theme is unknown or marked **Partially Supported** during **Theme Configuration** in the **Setup Guide**, the usual header badge placement may not be available or may require manual theme edits.
The floating badge is a good workaround because it gives shoppers a clear wishlist shortcut without relying on header auto-injection or manual header code placement.
Use it when you want the fastest no-code option. Manual theme setup is still available through **Manual theme icon placement**, but the floating badge is usually simpler if you only need a visible wishlist entry point.
Preview your storefront and confirm the badge does not overlap with other fixed elements like chat widgets, cookie bars, or sticky mobile buttons. If needed, fine-tune the **Position**, **Horizontal offset**, and **Vertical offset**.
The floating badge is especially useful if you want a reliable wishlist shortcut while avoiding theme-specific header injection issues.
---
### Can I set a request a quote button on wishlists?
**URL:** https://wysh.mantledocs.com/can-i-set-a-request-a-quote-button-on-wishlists
## Can I add a “request a quote” button to wishlists?
No. Wishlists don’t currently support adding a dedicated **request a quote** button.
## Workaround: use *Share Wishlist* to request a quote
Customers can still send their wishlist to your store by using the built-in **Share Wishlist** button on the wishlist page. They can send this to the business email address, so you can then access their wishlist to view it. You can then reply with a quote using the details from the shared list.
From the storefront, open the wishlist page (you’ll see the page title **My Wishlist**).
Select **Share Wishlist** on the right side of the page.
In your email app, address the message to your store’s email address and send it. The store owner can then review the wishlist items and reply with a quote.
**Tip:** If you want quote requests to be handled consistently, publish a dedicated “Quote requests” email address (or alias) and ask customers to send their **Share Wishlist** email there.
## What customers should include (recommended)
- Preferred quantities (especially if different from “1 of each”)
- Any personalization details (names, artwork, colors, sizes)
- Needed-by date and delivery location
The wishlist page also includes actions like **Create New List** and product-level actions (for example, removing items). These don’t submit a quote request—only **Share Wishlist** sends the list for review.
---
## Troubleshooting
### Troubleshooting Overview
**URL:** https://wysh.mantledocs.com/troubleshooting-overview
In this area, you’ll find guidance on troubleshooting for functionality and features within Wysh.
---
### Why isn't the wishlist icon showing in the header as expected?
**URL:** https://wysh.mantledocs.com/header-icon-troubleshooting
## What this guide covers
Use this guide if the Wysh wishlist icon is not appearing in your store header as expected when using automatic injection.
Wysh can automatically inject the header wishlist badge on fully supported themes. If your theme is not in the supported list below, you will need to use manual placement instead.
In Shopify theme settings, the header icon is controlled from **App embeds** for **Wysh** under **Wishlist visibility**. The setting called **Disable header wishlist badge** hides the automatically injected header badge.
## First, check whether your theme is fully supported
Auto-injection of the wishlist icon into the header is fully supported on these themes:
- Atelier
- Be Yours
- Broadcast
- Colorblock
- Craft
- Crave
- Concept
- Dawn
- Dwell
- Enterprise
- Eurus
- Fabric
- Generated Data Theme
- Heritage
- Horizon
- Origin
- Pitch
- Prestige
- Publisher
- Refresh
- Ride
- Rise
- Ritual
- Savor
- Sense
- Skeleton
- Spotlight
- Studio
- Solo
- Sleek
- Taste
- Tinker
- Trade
- Vessel
If your theme is not in this list, header auto-injection is not fully supported. In that case, use [Manual theme icon placement](/getting-started/manual-theme-icon-placement) instead of troubleshooting auto-injection.
## Checklist for fully supported themes
If your theme **is** in the supported list, work through these checks:
Open Wysh and make sure you completed setup on the same Shopify theme you are previewing.
If you installed Wysh on a draft theme, preview that draft theme rather than your live theme.
In Shopify admin, go to **Online Store**.
Open your theme editor, then open **App embeds**.
Find **Wysh** and make sure the embed is turned on. Then click **Save**.
In the **Wysh** embed settings, scroll to **Wishlist visibility**.
Make sure **Disable header wishlist badge** is turned **off**. If this setting is enabled, the automatically injected header badge will be hidden.
During setup using the installlation wizard, Wysh lets you choose **Default settings** or **Custom settings**.
If you chose **Default settings**, Wysh uses **a floating wishlist badge instead of a header icon**. That means you may not see a header icon at all.
If you want the wishlist entry point in the header, use the setup option that places the wishlist icon in the **header**.
The Wysh embed includes an **Override Wizard Settings** option.
If this is enabled, theme editor settings take precedence over wizard settings. If your storefront is not behaving as expected, review whether this setting matches how you want Wysh to be controlled.
## If your theme is not fully supported
If your theme is outside the supported list, use the manual placement method:
[Manual theme icon placement](/getting-started/manual-theme-icon-placement)
This guide shows where to add the header placeholder in your Shopify theme so the wishlist icon can appear in the right location.
## When to contact support
If your theme is on the fully supported list and you have already checked the **Wysh** app embed, **Wishlist visibility**, and the correct theme preview, please contact support so we can investigate.
For fully supported themes, the header icon should appear through auto-injection when the setup is correct.
If you need help with manual placement, contact support and we can assist.
To do that, we will need collaborator access to your store. Please include your **MyShopify URL** so we can send an access request for you to accept.
## Quick summary
- If your theme is in the fully supported list, the header icon should work through auto-injection.
- If it is not showing, first check **App embeds**, **Wishlist visibility**, and whether **Disable header wishlist badge** is turned on.
- If you used **Default settings** via the installation wizard, remember that Wysh uses a **floating wishlist badge instead of a header icon**.
- If your theme is not in the supported list, use [Manual theme icon placement](/getting-started/manual-theme-icon-placement).
- If a fully supported theme still does not show the header icon, contact support.
- If you want help with manual placement, contact support with your **MyShopify URL** so we can request collaborator access.
## Related guide
Use this guide if your theme is unsupported and you need to place the Wysh header icon manually.
---
### Why are my theme block settings not showing?
**URL:** https://wysh.mantledocs.com/wizard-settings-override-theme-styling
## Why your styling changes are not showing
If you change styling in the Wysh theme block settings and the changes do not appear on your storefront, the most common cause is that styling from the setup wizard is still taking priority.
During setup, Wysh can save custom display and styling options in the wizard if you opt for a customised set-up during installation. When those wizard settings are active, they can override any styling you have applied in the theme editor.
If your storefront does not match the styling set in the theme block, check whether the wizard configuration is still controlling the app.
## How Wysh decides which settings to use
- **Wizard settings** set during setup can take precedence over theme block styling.
- **Theme block settings** will only take priority again when **Override Wizard Settings** is enabled in the theme editor.
## Fix: enable Override Wizard Settings
In Shopify, open your theme editor and locate the **Wysh Wishlist** block.
In the Wysh block settings, look for the toggle labelled **Override Wizard Settings**.
Enable **Override Wizard Settings**. This makes the styling and settings in the theme editor take precedence over the wizard setup.
After enabling the setting, recheck your theme block styling changes. Your theme editor settings should now control the appearance again.
## Where to check related setup settings
If you want to review the original configuration that may be overriding your theme styling, refer to the **Installation** page in the Wysh app.
The text in the theme editor explains this directly: when **Override Wizard Settings** is enabled, theme settings take precedence over wizard setup.
## Quick answer
If styling set in your Wysh theme block is being ignored, it is usually because the setup wizard settings are overriding it. Turn on **Override Wizard Settings** in the **Wysh Wishlist** block to make your theme editor styling apply again.
---