Localization Conditions
Localization conditions let you customize checkout behavior based on the customer’s geographic market or checkout language. These are essential for international stores that serve different regions with different payment preferences.
Shopify Market
Section titled “Shopify Market”Condition key: shopifyMarket
Checks which Shopify Market the customer is purchasing through. Markets are configured in your Shopify admin under Settings → Markets.
Operators: Is one of, Is not any of
Use cases:
- Show region-specific payment methods (e.g. iDEAL only for Netherlands market)
- Apply different COD availability per market
- Display market-appropriate shipping options
- Rename payment methods differently per market language
Example: Show TWINT only for Switzerland market:
- Condition: Shopify Market → Is one of → Switzerland
- Action: Show TWINT (or hide TWINT when NOT Switzerland)
Example: Use different payment method names per market:
- Rule 1: Rename “Bank Transfer” → “Bankovní převod” when Shopify Market is Czech Republic
- Rule 2: Rename “Bank Transfer” → “Banküberweisung” when Shopify Market is Germany
Checkout language
Section titled “Checkout language”Condition key: language
Checks the language the customer is using at checkout. This is determined by the language the customer selected or the default language for their market.
Operators: Is one of, Is not any of
Payflow loads the languages available for your store; when you set this condition, choose from the dropdown—the values match Shopify checkout locale tags (IETF BCP 47), so they stay in sync with what customers actually see.
Use cases:
- Display payment instructions in the customer’s language
- Show localized shipping method names based on checkout language
- Apply rules for specific language audiences
Example: Show Czech bank transfer instructions in Czech:
- Condition: Checkout language → Is one of →
cs - Action: Show payment instructions with Czech text
Market vs Language — which to use?
Section titled “Market vs Language — which to use?”| Scenario | Use |
|---|---|
| Rules based on geographic region | Shopify Market |
| Rules based on the language displayed | Checkout language |
| Store has one market per country | Either works |
| Store has one market for multiple languages | Language is more precise |
For most stores, Shopify Market is the right choice since it maps directly to geographic regions and their associated currencies, taxes, and payment methods.