Shopify product sync

You can sync all products from your Shopify store to a Braze catalog for deeper messaging personalization.

Shopify catalogs will update in near real-time as you make edits and changes to the products in your Shopify store. You can enrich your abandoned cart, order confirmation, and more with the most up-to-date product details and information.

Setting up your Shopify product sync

If you have already installed your Shopify store, you can still sync your products by following the instructions below.

Step 1: Turn on the sync

You can sync your products to a Braze catalog through the Shopify install flow or on the Shopify partner page.

Products synced to a Braze catalog will contribute to your Catalog limit.

Step 2: Select your product identifier

Select what product identifier to use as the catalog ID:

• Shopify Variant ID
• SKU

The ID and header values for the product identifier you choose can only include letters, numbers, hyphens, and underscores. If the product identifier doesn’t follow this format, Braze will filter it out of your catalog sync.

This will be the primary identifier you use to reference Braze catalog information.

Step 3: Sync in progress

You will receive a dashboard notification, and your status will display as “In Progress” to indicate the initial sync is starting. Note that the time it takes for the sync to finish will depend on how many products and variants Braze will need to sync over from Shopify. During this time, you can leave this page and wait for a dashboard notification or email to notify you when this is complete.

Note that if your initial sync exceeds your catalog limit, Braze will stop syncing any more products. If you exceed the limit after the sync is successful due to new products being added over time, the sync will no longer be active. In both these cases, product updates from Shopify will no longer be reflected in Braze. Reach out to your account manager to consider upgrading your tier.

Step 4: Sync completed

You will receive a dashboard notification and an email after the sync is successful. The Shopify partner page will also update the status under Shopify catalogs to “Syncing”. You can view your products by clicking the catalog name on the Shopify partner page.

Refer to Catalogs additional use cases to learn more about how to leverage catalog data to personalize your message.

Supported Shopify catalog data

• id
• store_name
• shopify_product_id
• shopify_variant_id
• product_title
• variant_title
• status
• body_html
• product_image_url
• variant_image_url
• vendor
• product_type
• product_url
• product_handle
• published_scope
• price
• compare_at_price
• inventory_quantity
• options
• option_values
• sku

Using product_handle or product_url

To access and use product_handle and product_url, disconnect and reconnect your Shopify catalog by doing the following.

1. Go to the Shopify integration page and select Edit configuration.

2. In the Sync catalog step, toggle off the catalog and then update the settings.
3. Toggle on the catalog and update the settings.

Back-in-stock and price-drop use cases

To set up back-in-stock notifications, follow the steps here.

To set up price drop notifications, follow the steps here.

Note that with the Shopify integration, you’ll need to create a custom event that captures a user’s subscription status in your catalog for each use case. The custom event will require an event property that maps to either the SKU or Shopify variant ID that you have selected as part of your Shopify product sync.

Changing catalog ID

To change the product identifier for your Shopify catalog, you will need to deactivate the sync. Confirm you have stopped sending any messages using this Shopify catalog data first. Re-run the Shopify catalog initial sync and select your desired product identifier by following the product sync steps.

Deactivating your product sync

Deactivating the Shopify product sync feature will delete your entire catalog and products. This can also impact any messages that may be actively using the product data from this catalog. Confirm that you have either updated or paused these campaigns or Canvases before deactivation, as this could result in sending messages with no product details. Do not delete the Shopify catalog directly on the catalogs page.

Troubleshooting

If your Shopify product sync runs into an error, it could be a result of the following errors. Follow the instructions on how to correct the issue and resolve the sync:

Error	Reason	Solution
Server Error	This occurs if there is a server error on Shopify’s side when we attempt to sync your products.	Deactivate sync and re-sync your entire inventory of products again.
Duplicate SKU	This occurs if you use a SKU as your catalog item ID and have products with the same SKU. Since catalog item ID has to be unique, all your products must have unique SKUs.	Audit your full list of products and variants in Shopify to make sure that there are no duplicate SKUs. If there are duplicate SKUs, update these to be unique SKUs only in your Shopify store account. After this is corrected, deactivate sync and re-sync your entire inventory of products again.
Catalog Limit Exceeded	This occurs if you exceed your catalog limit. Braze will be unable to finish the sync or keep the syncing active due to no more storage availability.	There are two solutions to this issue: 1. Reach out to your account manager to upgrade your tier to increase your catalog limit. 2. Free up storage space by deleting any of the following: - Catalog items from other catalogs - Other catalogs - Selections created After using either of the solutions, the sync must be deactivated and then re-synced.