Shopify Markets Early Adopter Program
Shopify Markets lets you control product pricing and availability for different regions.
This guide explains how Shopify Markets works with Recharge and provides instructions on enabling the feature.
- Shopify Checkout Integration
- Migrated Shopify Checkout Integration
Before you start
- Recharge compatibility with Shopify Markets is in Early Adopter status. See Early Adopter Program for more information.
- You must be a Shopify merchant with Shopify Markets enabled in your Shopify admin to use Recharge with Shopify Markets.
- Changes made in Shopify Markets (for example, turning on a feature, editing prices, or changing catalog availability) do not affect existing subscriptions. Changes only apply to subscriptions when you or a customer edits the subscription, such as adding or swapping a product.
- It is recommended that you update Recharge’s collaborative access settings and relevant staff permissions to include Shopify Markets permissions to help Recharge Support troubleshoot issues effectively.
How it works
Shopify Markets is a Shopify feature that lets you localize pricing and control product availability across regions (countries or groups of countries). Recharge supports Shopify Markets rules across major subscription flows, helping ensure consistency between storefront and subscription management.
Recharge synchronizes pricing and availability rules from Shopify Markets in near real time. These rules are respected across Recharge features, including Automate, Bundles, Rewards experiences, and add/swap flows.
Recharge ensures a seamless experience for Shopify Markets users by:
- Supporting fixed pricing, as well as manual and dynamic exchange rates, rounding rules, and Shopify conversion fees
- Using your Shopify settings to determine product availability by Market
- Detecting the correct market based on the customer’s address
Once you've set up Shopify Markets in Recharge, your updated Market settings will continue to sync automatically. Pricing and product availability updates made in Shopify are reflected in Recharge without any additional action required.
Recharge determines the correct Market for each action using the customer’s shipping address, the address tied to the upcoming order, or the country detected before address entry (for example, during gift redemption).
See Shopify’s guide to managing markets for instructions on setting up markets, or international sales tools for details on configuring product pricing and availability per region.
Product availability
Recharge treats product availability differently for customers and merchants.
Customer behavior
- Customers cannot select, add, or swap products that are unavailable in their Market
- The customer portal displays only products available in the region Shopify defines
Merchant behavior
- You can add products unavailable in a Market
- Recharge displays a warning but still processes the request for overrides
Detailed behavior across Recharge features
Below is an expanded explanation of how Shopify Markets affects different Recharge features.
Feature |
Behavior |
| Add/Swap in the Customer Portal |
|
| Add/Swap in the Merchant Portal |
|
| Gift subscriptions |
|
| Rewards |
|
| Cancellation Prevention (with free gifts) |
|
| Automate |
|
| Bundles |
|
| Prepaid subscriptions |
|
| Subscription reactivations in Affinity or Unity |
|
| Win Backs |
|
|
Key features
Shopify Markets is a key tool to support your international expansion efforts. With Shopify Markets and Recharge, you can localize prices by market for subscriptions, bundles, and gifts. Shopify Markets integrates with most Recharge features, including, but not limited to:
- Customer portals: Displays pricing and availability set in Shopify Markets
- Gift subscriptions and Rewards: Free gifts and rewards reflect the correct market pricing and availability
- Automate: Automate flows that use market-based pricing to keep updates consistent across regions
- Bundles: All bundle types respect market pricing and availability automatically
- Checkout and upsells: The subscription widget, cart, and upsell experiences all apply localized pricing and product availability.
Set-up instructions
Recharge compatibility with Shopify Markets is currently in Early Adopter status. You can enable this feature in Recharge:
- In the merchant portal, click Settings and select Store.
- Click Set up Markets in Recharge to enable Markets.
- Select Approve permissions in Shopify to update your Shopify permissions so that Recharge can view product listings and collections in your store.
- After updating your Shopify permissions, click I've updated permissions: complete setup.
By default, the Affinity and Unity customer portals are compatible with Shopify Markets after you enable the feature. If you use a different customer portal, ensure that product pricing and availability reflect the correct Shopify Market. See Updating Custom Portals for detailed instructions.
Considerations
Consider the following when using Shopify Markets:
Consideration |
Notes |
| Dynamic pricing |
|
| Shopify limitations |
|
| Prepaids with Variant Level Plans |
|
| Currency retention |
|
| Free gifts |
|
| Swap actions |
|
