Shopify segments sync

The Shopify segments sync extends your Shopify store into Braze, giving your marketing team direct access to richer user data that lives in Shopify, including signals that aren’t captured by the standard Braze Shopify integration. By syncing Shopify segments as cohorts, you align audience definitions across both platforms and deliver consistent, coordinated user experiences whether a user is targeted in Shopify or engaged through a Braze campaign.

Prerequisites

Requirement	Description
Braze Shopify integration	The Braze Shopify app must be installed on your Shopify store and connected to a Braze workspace. For setup instructions, see Shopify Standard Integration Setup or Shopify Custom Integration Setup.

How it works

The Shopify segments sync works in two phases.

1. When you first sync a segment, Braze backfills all current members and creates a corresponding cohort in Braze. The backfill runs asynchronously and may take a few moments to complete.
2. During the initial sync, Braze backfills current members and subscribes to Shopify webhooks so membership stays synced in near real-time.

Webhook topic	Effect in Braze
customer.joined_segment	The user is added to the corresponding Braze cohort.
customer.left_segment	The user is removed from the corresponding Braze cohort.

If a sync fails, the action extension modal displays an error banner with a recommended action. Select Sync with Braze to retry.

Data import integration

Step 1: Select a Shopify segment to sync

In Shopify, go to Customers > Segments, and select the segment you want to sync to Braze. You can sync any segment built using Shopify’s native segmentation, including segments based on order history, product purchases, customer tags, lifetime spend, and metafields.

Step 2: Initiate the sync

1. On Shopify’s segment detail page, open the Use segment dropdown and select Braze Segment Sync.

2. In the Braze action extension modal that opens, displaying the segment name and audience size. Select Sync with Braze to begin the import.

3. Select Done.

Step 3: Create a Braze segment with the Cohort Membership filter

In Braze, go to Audience > Segments, and create a new segment. In Add Filter, select the Cohort Membership filter and select your synced Shopify segment from the dropdown. After saving, you can reference this Braze segment when targeting users in a campaign or Canvas.

User matching

Users synced from Shopify segments are matched to Braze user profiles using the shopify_customer_id alias that is set as part of the Braze Shopify integration. Users without a matching Braze user profile are skipped during sync.

For details on how the Shopify integration identifies and aliases users, see Shopify Data Features.

Limitations

• One-way sync. Segment membership flows from Shopify to Braze only. Changes to cohort membership made directly in Braze are not pushed back to Shopify.
• No profile creation. Only Shopify customers who already have a Braze user profile are added to the cohort.
• No undoing syncs. When a Shopify segment is synced, it cannot be undone.