Shopify integration
Integration overview
Section titled âIntegration overviewâPushwoosh integrates seamlessly with Shopify, a leading e-commerce platform that enables businesses to create, manage, and scale online stores. This guide walks you through installing and configuring the Pushwoosh app in your Shopify store, setting up user identification, and using notifications and automation tools to engage customers across mobile and web.
Integration type
Section titled âIntegration typeâ- Destination: Shopify sends customer data to Pushwoosh, where it is used for targeting and messaging.
Prerequisites
Section titled âPrerequisitesâ- A Pushwoosh account
- Access to your Shopify admin panel
- Pushwoosh API Access Token and Application Code
- A Shopify store with customers and order data available
Synchronized entities
Section titled âSynchronized entitiesâ- Customers: Used to assign and identify Pushwoosh UserIDs via Shopify metafields
- Customer segments: Used for group-based targeting and messaging
- Events and triggers (e.g., orders placed, tags applied): Used in Shopify Flow to automate push messaging
- Storefront: Used for capturing web push opt-ins through embedded scripts
Glossary (mapping entity names if they are different)
Section titled âGlossary (mapping entity names if they are different)âShopify | Pushwoosh |
---|---|
Customer | UserID |
How the integration works
Section titled âHow the integration worksâPushwoosh acts as a messaging destination for Shopify. Once integrated, Shopify sends customer and behavioral data to Pushwoosh, where it powers real-time notifications, customer segmentation, and personalized messaging across web and mobile.
Key components of the integration
Section titled âKey components of the integrationâCustomer identification via metafields
Each Shopify customer is assigned a uniqueUserID
, stored in a metafield (custom.pushwoosh_userid
). This ID allows Pushwoosh to recognize and message users consistently across platforms.Event-driven automation via Shopify Flow
Pushwoosh provides Flow actions that allow you to automate push notifications based on Shopify events, such as:- New order placed
- Tag applied to customer
- Cart abandonment
Segment-based targeting
Customer segments from Shopify can be used to send group-specific push notifications, such as promotions for first-time buyers or reactivation campaigns for dormant users.Manual and real-time messaging
From the Shopify customer or segment view, you can manually trigger notifications using the Pushwoosh Extensions:- Notification by Customer: For personal follow-ups or testing
- Notification by Segment: For campaign-based messages
Web push notifications via storefront embed
Section titled âWeb push notifications via storefront embedâBy enabling the Pushwoosh embed in your Shopify theme, you can prompt website visitors to opt in to browser-based push notificationsâno mobile app required.
Data flow overview
Section titled âData flow overviewâShopify Customer & Event Data âPushwoosh API (via App) âUserID â Segmentation â Triggered or Manual Notifications
This integration empowers you to deliver timely, relevant messages that improve user retention, boost conversions, and enhance the customer experienceâautomatically or on demand.
Part 1. Installation
Section titled âPart 1. InstallationâLog into Shopify
Section titled âLog into Shopifyâ- Go to Shopify Admin
- Select your store from the dashboard
Install the Pushwoosh app
Section titled âInstall the Pushwoosh appâ- Visit the Pushwoosh App Store page
- Click Install
- Confirm installation in the Shopify dialog
Connect your Pushwoosh app
Section titled âConnect your Pushwoosh appâAfter installation, you will be redirected to the Pushwoosh app inside Shopify.
- Click Connect.
- Enter the Application Code and API Access Token, which you can find in the Pushwoosh Control Panel â Settings â API Access.
When connected, a success message will appear: âPushwoosh app connected.â
Subscribe to a plan
Section titled âSubscribe to a planâ- Click Upgrade Subscription
- A single usage-based plan will be shown.
- Confirm the billing.
Part 2. Setup: Customer userID via metafields
Section titled âPart 2. Setup: Customer userID via metafieldsâTo deliver mobile push notifications to identified users, Pushwoosh uses a unique UserID per customer. We store this value inside Shopifyâs Customer metafields.
Step-by-step guide
Section titled âStep-by-step guideâ1. Go to Settings â Custom Data â Metafield Definitions â Customers
2. Click Add definition and use these values:
Field | Value |
---|---|
Name | pushwoosh_userid |
Namespace | custom |
Type | Single line text |
Validation | None |
Customer Account Access | Read and Write |
Storefront API Access | Enabled |
Part 3. Using Pushwoosh extensions
Section titled âPart 3. Using Pushwoosh extensionsâPushwoosh includes Shopify Extensions for segment targeting, automation (Flow), and customer-specific notifications.
Extension 1. Send notification by customer
Section titled âExtension 1. Send notification by customerâUse case
Section titled âUse caseâManually send personalized messages or test notifications to a specific user.
- Open Customers â Select a customer
- Click More actions â Notification by customer
- Select the messaging platform (e.g., Email) and a content preset.
- Click Send
Extension 2. Notification by segment
Section titled âExtension 2. Notification by segmentâUse case
Section titled âUse caseâTarget groups of customersâabandoned carts, first-time buyers, high spenders.
Go to Customers â Segments
Choose a segment â Click Use Segment
- Select Notification by Segment
- Select the desired communication channel and message preset. Click Send.
Extension 3. Pushwoosh in Shopify Flow
Section titled âExtension 3. Pushwoosh in Shopify FlowâUse case
Section titled âUse caseâAutomate messaging in customer journeys using triggers like orders, tags, or behavior.
- Create a new Flow in Shopify Flow
- Add action â Choose Pushwoosh notifications
- Configure message and dynamic fields
For example:
Send a message after order placed
Remind user when cart is abandoned
Send reactivation push after 30 days of inactivity
Part 4. Enable web push (optional but recommended)
Section titled âPart 4. Enable web push (optional but recommended)âTo support browser-based web push notifications on your storefront, do the following:
- Go to Online Store â Themes â Customize
- Open App Embeds from the left menu
- Toggle Push Init Embed ON
Use cases summary
Section titled âUse cases summaryâScenario | Tool used |
---|---|
Personalized follow-up | Notification by Customer |
Cart abandonment reminder | Shopify Flow + Pushwoosh action |
Segment-based promotion | Notification by Segment |
Welcome message after signing up | Flow + Metafield tracking |
Push opt-in | Theme Embed + Push Init Toggle |