Skip to content

Shopify product sync

You can sync your products from your Shopify store into a Braze catalog, automating how you bring in product data for deeper personalization of your messages.

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.

Step 3 of the set up process with "Shopify Variant ID" as the "Catalog product identifier".

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

Changing catalog ID

To change the product identifier for your Shopify catalog, you will need to deactivate the sync. Confirm you have stopped any sends 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 sends that may be actively using the product data from this catalog. Confirm that you have either updated or paused these sends before deactivation, as this could result in your messaging sending missing product details. Do not delete the Shopify catalog directly on the catalogs page.


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.
New Stuff!