How to use Customer Hub with Shopify Markets
You will learn
Learn how Customer Hub uses Shopify Markets to display localized product information, currency, and pricing, and how to check whether your Shopify integration needs updated permissions.
Requirements
- You must have a Shopify store with Shopify Markets configured.
- You must have Klaviyo Customer Hub installed and active.
Overview
If you use Shopify Markets to sell in multiple regions, Customer Hub uses the active market on your Shopify storefront to show customers the appropriate product information.
Customer Hub uses your Shopify storefront's market context to localize product information, currency, and pricing.
How it works
Customer Hub reads the country and language active on your Shopify storefront. Your Shopify theme needs to update this context when a customer changes their region or language.
Customer Hub uses this context to:
- Localize product catalogs: Product names, descriptions, and availability will match the specific market settings in Shopify.
- Display currencies and prices: Product recommendations display market-specific prices and currency. Order amounts, including recent purchases, are formatted using the currency in the order details.
- Align with storefront language: The language displayed in the Hub will attempt to match the language currently active on your Shopify storefront. For supported languages and custom-content translations, see how to localize Customer Hub for multi-language stores.
Note: While Customer Hub supports localization, the AI Agent and Inbox features currently support English only.
Check Shopify Markets permissions
Customer Hub uses your Shopify market context automatically. Older Shopify integrations may need updated permissions to check product availability in each market. You need permission to edit integrations to complete the update. To check your integration:
- In Klaviyo, open your Shopify integration settings.
- If a warning asks you to update the integration, click Update. For a store with multiple markets, the Markets warning says "Update your Shopify integration for full Shopify Markets support." The same Update button is used if a Shopify login or another permission warning takes priority. If no update warning appears, continue to the storefront check below.
- Complete the authorization prompts to grant the requested Shopify permissions. If Klaviyo asks you to confirm the update, click Update Integration.
- Check Customer Hub on your storefront in each market you sell to. Confirm that product availability, prices, and currencies match the active market.
If your Shopify integration is missing permission to check market availability, Customer Hub can still show translated product names, currency symbols, and prices, but products may appear in markets where they are unavailable, including in recommendations, recently viewed products, and favorites. Update your Shopify integration to grant the required permission.
Troubleshooting
Why is the wrong currency showing? For product prices, Customer Hub uses your storefront's active currency and market context. Check that your Shopify theme updates window.Shopify.country and window.Shopify.currency.active when a customer changes regions. Order amounts use the currency in the order details. If you need help checking your theme's values, ask your theme developer.
Why are some products missing in the Hub? Check that the product is published to the customer's market in Shopify. With the required market-availability permission, products that are not published to that market are excluded from Customer Hub.