> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://stoqapp.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Sync customer data from STOQ to your Shopify Customers list

When a visitor signs up for a back-in-stock or preorder alert through STOQ, the app can automatically add them to your **Shopify Customers** list. Each synced customer is tagged so you can quickly identify and segment alert subscribers directly in Shopify admin. STOQ also updates their email and SMS marketing consent, making it easy to sync customer data from STOQ to your Shopify Customers list and keep your records up to date.

### Before You Begin

Make sure you have the following before you enable the Shopify sync:

* A **paid STOQ plan** (the Shopify customer sync is not available on the free plan)
* STOQ installed and active on your Shopify store

| Tip: This feature syncs customer profiles to your Shopify Customers list. It does not affect other integrations like Klaviyo or Omnisend. Each integration is enabled separately.

### How to Enable the Shopify Customer Sync

Follow these steps to start syncing alert subscribers to your Shopify Customers list.

##### Step 1: Open the Integrations Page

1. Open the **STOQ** app in your Shopify admin.
2. Click **Back in stock alerts** in the left-hand menu.
3. Navigate to the **Settings** section, then scroll to **Integrations**.
4. Click **Set up** on the **Shopify** card.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/6/9/b/f69b1402a211d800/image_1qn8597.png)

##### Step 2: Turn On the Sync Toggle

1. Turn on the **Sync visitors with Shopify** toggle.
2. Click **Save** in the top bar to confirm.

Once enabled, every customer who registers for a back-in-stock or preorder alert is automatically added to your Shopify Customers list.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/6/9/b/f69b1402a211d800/image_18rtw4q.png)

##### Step 3: Set Your Profile Tag

1. After enabling the toggle, a **Profile tags** field appears below the toggle.
2. Enter a tag value (for example, `restock-rocket` or `back-in-stock-signup`).
3. Click **Save**.

STOQ adds this tag to every customer it syncs to Shopify. The default value is **restock-rocket**. You can use this tag to filter and segment alert subscribers in your Shopify admin.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/6/9/b/f69b1402a211d800/image_p1pd36.png)
|| Note: The profile tag is shared across all your enabled marketing integrations (Shopify, Klaviyo, Omnisend, Mailchimp). Changing it here updates the tag for every platform.

### What STOQ Syncs to Shopify

STOQ sends detailed customer information to your Shopify Customers list so your records stay complete.

##### Customer Details

When a customer signs up for an alert, STOQ creates or updates their Shopify customer profile with:

* **Email address** (if provided during signup)
* **Phone number** (if provided during signup)
* **First name** and **Last name** (parsed from the customer name, if provided)
* **Tag** (your profile tag value, default: `restock-rocket`)

##### Marketing Consent

If the customer opted in to marketing during signup, STOQ also updates their consent status in Shopify:

* **Email marketing consent** is set to **Subscribed** (single opt-in)
* **SMS marketing consent** is set to **Subscribed** (single opt-in)

This means customers who accept marketing through STOQ's signup form are automatically marked as subscribed in Shopify, so you can include them in your email and SMS marketing campaigns.

| Tip: Marketing consent is only updated when the customer has opted in. If a customer does not accept marketing, their consent status in Shopify is not changed.

### How STOQ Handles Existing Customers

STOQ checks whether a customer already exists in your Shopify Customers list before creating a new entry.

* **If the customer already exists** (matched by email or phone number): STOQ updates their profile by appending the tag to their existing tags. Existing customer details like name, email, and phone are preserved.
* **If the customer is new**: STOQ creates a new customer entry in Shopify with the details from the alert signup.

This means you will never get duplicate customers in your Shopify list from STOQ syncing.

### Finding STOQ Customers in Shopify Admin

Once syncing is enabled, you can find all STOQ-sourced customers in your Shopify admin.

1. Go to your **Shopify admin** and click **Customers** in the left-hand menu.
2. In the search or filter bar, search for the tag value you set (for example, `restock-rocket`).
3. Shopify displays all customers with that tag.

You can also create a saved segment in Shopify admin using the tag to keep a permanent filtered view of your STOQ subscribers.
![](https://storage.crisp.chat/users/helpdesk/website/-/f/6/9/b/f69b1402a211d800/image_xyeujl.png)
### Known Limitations

There are a few constraints to keep in mind when using the Shopify customer sync.

* The Shopify sync requires a **paid STOQ plan**. Free-plan stores cannot enable it.
* STOQ syncs customers **one at a time** as they sign up. There is no bulk retroactive sync for customers who signed up before you enabled the integration.
* Customers who sign up with **push notifications only** (no email or phone) are not synced to Shopify because Shopify requires at least an email or phone number.
* The **profile tag** field is shared across all marketing integrations. You cannot set a different tag for Shopify and Klaviyo independently.
* If a customer already exists in Shopify, STOQ **appends** the tag but does not overwrite their existing name, email, or phone number.
* Marketing consent is only updated to **Subscribed**. STOQ does not unsubscribe customers or change existing consent to a lower level.

### Troubleshooting

If customers are not appearing in your Shopify Customers list as expected, check the table below.

| Symptom | Likely Cause | Fix |
| ---- |
| Customers are not syncing to Shopify | The sync toggle is not enabled | Go to **Back in stock alerts** > **Settings** > **Integrations** > **Shopify** and turn on **Sync visitors with Shopify** |
| Customers are not syncing to Shopify | Store is on the free STOQ plan | Upgrade to a paid plan under **Plans** in the left-hand menu |
| Customer appears in Shopify but without the tag | The profile tag field was empty when they signed up | Enter a tag value in the **Profile tags** field and click **Save**. The tag only applies to future signups |
| A customer signed up but is not in Shopify | The customer used push notifications only | STOQ cannot sync push-only customers. Shopify requires an email or phone number |
| Customer exists in Shopify but marketing consent was not updated | The customer did not opt in to marketing | STOQ only updates consent when the customer accepts marketing during signup |
| Duplicate customer tag appears | This should not happen — STOQ deduplicates tags | Check if the tag was manually added and appears to be duplicated with different spacing |

### FAQs

**Q**: **What tag does STOQ add to synced customers?**
**A:** STOQ adds the value from the **Profile tags** field to each synced customer. The default is `restock-rocket`. You can change this at any time in the STOQ app under **Back in stock alerts** > **Settings** > **Integrations** > **Shopify** > **Profile tags**.

**Q:** **Does STOQ create duplicate customers in Shopify?**
**A:** No. STOQ searches for existing customers by email and phone number before creating a new entry. If a match is found, STOQ updates the existing customer instead of creating a duplicate.

**Q:** **Does STOQ sync customers who signed up before I enabled the integration?**
**A:** No. STOQ only syncs customers going forward from the moment you enable the integration. Customers who signed up before the toggle was turned on are not retroactively synced.

**Q:** **Will disabling the sync toggle remove customers from Shopify?**
**A:** No. Turning off the toggle only stops new customers from being synced. Customers already in your Shopify Customers list remain untouched, including their tags and consent status.

**Q:** **Can I use a different tag for Shopify and Klaviyo?**
**A:** No. The profile tag is shared across all enabled marketing integrations. If you change the tag, it updates for Shopify, Klaviyo, Omnisend, and Mailchimp at the same time.

**Q:** **Does STOQ update marketing consent for existing Shopify customers?**
**A:** Yes, if the customer opts in to marketing during their alert signup. STOQ sets their email and SMS marketing consent to **Subscribed** in Shopify. If they do not opt in, their existing consent status is not changed.