> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/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). # πŸ”— Integrate PopUps App with Shopify Customers Connecting Hoppy PopUps with Shopify Customers lets you automatically turn popup subscribers into official Shopify customer records. Every email or phone number submitted through a popup can instantly create or update a customer profile inside your Shopify admin. This integration also handles marketing consent settings, so you stay compliant while growing your customer list. --- # **⚠️ Before You Begin** Before setting up this integration, make sure: * The **Hoppy PopUps** app is installed on your Shopify store * You have admin access to your Shopify store No external API keys are needed for this integration β€” it works natively through Shopify's platform. --- # **πŸ› οΈ Step 1 β€” Open the Integrations Section** Open the **Hoppy PopUps** app from your Shopify Admin. Then: β†’ Click the **Integrations** tab from the left-side navigation menu Locate the **Shopify Customer List Integration** card. --- # **βš™οΈ Step 2 β€” Enable the Integration** Inside the Shopify Customer List Integration card: β†’ Toggle the β€œEnable Shopify customer list sync” **YES** This tells the app to start creating Shopify Customer records every time a visitor submits a popup form. --- # **πŸ“§ Step 3 β€” Configure Email Subscription** Below the main toggle, you'll find: β†’ **Email Subscription** This controls the marketing consent state for newly created customers. * **Enabled (default)** β€” Customers are created with **SUBSCRIBED** email marketing consent * **Disabled** β€” Customers are created with **NOT SUBSCRIBED** email marketing consent The consent level is always set to **Single Opt-In**, which is the standard for popup-based subscriptions. ⚠️ **Important:** If you disable email subscription, customers will still be created in Shopify, but they won't be marked as email marketing subscribers. This may affect your ability to send them marketing emails through Shopify Email or other tools. --- # **πŸ”„ Step 4 β€” Sync Previous Emails (Optional)** If you already have subscriber data collected before enabling this integration, you can retroactively create Shopify Customers from existing records. β†’ Click **Sync Previous Emails** The app will process your existing subscriber database and create Shopify Customer profiles for each unique email and phone number. * Existing customers are **updated** with any new phone numbers or locale info * New customers are **created** with full contact and consent details * The sync skips duplicates automatically --- # **βœ… Step 5 β€” Save the Integration** After configuring the settings: β†’ Click **Save** The integration is now active. From this point forward, every popup submission will automatically flow into your Shopify Customers list. --- # **πŸ§ͺ Step 6 β€” Test the Integration** To verify everything is working: β†’ Open your storefront in an **Incognito or Private** browser window β†’ Trigger a popup and submit a test email address Example: `testcustomer@example.com` Then: β†’ Go to **Shopify Admin β†’ Customers** β†’ Search for the test email β†’ Verify that: * The customer record exists * The email and phone (if submitted) are present * The email marketing consent shows **Subscribed** (if you left the toggle enabled) --- # **⚠️ Common Troubleshooting** ## **Customer Not Created** If a submission doesn't create a customer: β†’ Verify the Shopify Customer List Integration toggle is **YES** β†’ Verify the popup is **published** and active β†’ Check that the submitted email is valid β†’ If the customer already exists, the app updates instead of creating β€” check the existing record for changes ## **Marketing Consent Missing** If the customer is created but consent is not set: β†’ Verify **Email Subscription** is toggled **ON** in the integration settings β†’ Note that consent is only set at creation time; editing the integration later does not retroactively update past customers --- # **πŸŽ‰ Final Result** Once configured successfully: βœ… Every popup submission creates or updates a Shopify Customer record βœ… Marketing consent is set automatically βœ… Phone numbers sync alongside emails when collected βœ… Existing subscribers can be backfilled with one click βœ… Your customer list stays centralized inside Shopify πŸ”— ---