> For the complete documentation index, see [llms.txt](https://responsive-media.gitbook.io/advanced-free-shipping/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://responsive-media.gitbook.io/advanced-free-shipping/conditions-location/market.md).
# Market
## Overview
The **Shopify Market** condition applies discounts based on which Shopify Market the customer is shopping in. Markets let you customize products, pricing, and settings for different regions.
{% hint style="info" %}
This condition requires Shopify Markets to be configured in your store. Markets are available on Shopify Plus and some other plans.
{% endhint %}
## What are Shopify Markets?
Shopify Markets let you sell to multiple countries and regions with customized experiences:
* **Primary Market** - Your default market (usually your home country)
* **International Markets** - Additional regions you sell to
* **Market-specific settings** - Currencies, domains, pricing, languages
## Available Operators
**Is** - Customer is shopping in the specified market.
**Is not** - Customer is NOT shopping in the specified market.
## Common Use Cases
### Market-Specific Free Shipping
**Free shipping for your primary market**
**Configuration**:
* Condition: Market **is** "United States"
* Target: All shipping rates → Free
**Use case**: Offer free shipping to your home market where shipping costs are lower.
### International Shipping Discount
**Discounted shipping for international markets**
**Configuration**:
* Condition: Market **is not** "United States"
* Target: All shipping rates → $10 off
**Use case**: Subsidize expensive international shipping to encourage global sales.
### Market-Specific Thresholds
**Different free shipping thresholds by market**
* Rule Group 1 (US Market):
* Condition 1: Market **is** "United States"
* Condition 2: Cart total **is at least** $50
* Rule Group 2 (EU Market):
* Condition 1: Market **is** "European Union"
* Condition 2: Cart total **is at least** €60
* Rule Group 3 (UK Market):
* Condition 1: Market **is** "United Kingdom"
* Condition 2: Cart total **is at least** £45
{% hint style="info" %}
Markets automatically handle currency conversion, so you can set thresholds in each market's currency.
{% endhint %}
### Exclude Specific Markets
**Free shipping everywhere except one market**
**Configuration**:
* Condition: Market **is not** "Australia"
* Target: All shipping rates → Free
**Use case**: Exclude markets with prohibitively expensive shipping.
## Market vs Country
Understanding the difference:
| Feature | Market Condition | Country Condition |
| ------------------ | ------------------------- | ---------------------- |
| **Granularity** | Groups of countries | Individual countries |
| **Setup required** | Must configure Markets | Works automatically |
| **Currency aware** | Yes, uses market currency | No |
| **Best for** | Regional strategies | Country-specific rules |
**Example**:
* **Market "European Union"** includes France, Germany, Italy, Spain, etc.
* **Country "France"** is just France
{% hint style="info" %}
If you have Markets configured, using the Market condition is usually easier than listing individual countries.
{% endhint %}
## Combining with Other Conditions
### Market + Value
**Free shipping for US orders over $50**
* Condition 1: Market **is** "United States"
* Condition 2: Cart total **is at least** $50
### Market + Customer
**VIP customers get free shipping in all markets**
* Rule Group 1 (VIP):
* Condition: Customer tag **contains** "VIP"
* Rule Group 2 (US High Value):
* Condition 1: Market **is** "United States"
* Condition 2: Cart total **is at least** $75
### Market + Product
**Free shipping on specific products in specific markets**
* Condition 1: Market **is** "Canada"
* Condition 2: Collection **contains** "Canadian Exclusive"
## Examples by Strategy
{% tabs %}
{% tab title="Domestic vs International" %}
**Goal**: Different shipping strategies for domestic and international
**Discount 1** (Domestic):
* Condition 1: Market **is** "United States"
* Condition 2: Cart total **is at least** $50
* Discount: Free shipping
**Discount 2** (International):
* Condition: Market **is not** "United States"
* Discount: $15 off shipping
**Result**: Domestic gets free shipping at $50, international gets flat $15 off.
{% endtab %}
{% tab title="Multi-Market Tiers" %}
**Goal**: Optimized thresholds for each major market
**Discount 1** (US):
* Market **is** "United States"
* Cart total **is at least** $50
**Discount 2** (Canada):
* Market **is** "Canada"
* Cart total **is at least** $75 CAD
**Discount 3** (UK):
* Market **is** "United Kingdom"
* Cart total **is at least** £50
**Discount 4** (EU):
* Market **is** "European Union"
* Cart total **is at least** €60
{% endtab %}
{% tab title="Market Exclusion" %}
**Goal**: Free shipping everywhere except high-cost markets
**Configuration**:
* Condition 1: Market **is not** "Australia"
* Condition 2: Market **is not** "New Zealand"
* Condition 3: Cart total **is at least** $75
* Discount: Free shipping
**Result**: All markets except AU/NZ get free shipping at $75.
{% endtab %}
{% tab title="Regional Promotion" %}
**Goal**: Limited-time promotion for specific market
**Configuration**:
* Condition 1: Market **is** "European Union"
* Condition 2: Cart total **is at least** €40
* Active dates: June 1-30, 2024
* Discount: Free shipping
**Result**: EU summer promotion with lower threshold.
{% endtab %}
{% endtabs %}
## Setting Up Markets in Shopify
If you don't have Markets configured yet:
1. **Go to Markets** - In Shopify admin, go to **Settings** > **Markets**.
2. **Create Market** - Click **Add market** and select countries to include.
3. **Configure Settings** - Set currency, domain, language, and pricing for the market.
4. **Activate Market** - Save and activate the market.
{% hint style="info" %}
Once Markets are configured, they'll appear in the Market condition dropdown in Advanced Free Shipping.
{% endhint %}
## Best Practices
{% hint style="info" %}
**Group similar regions.** Create markets for regions with similar shipping costs (e.g., "European Union" instead of individual EU countries).
{% endhint %}
{% hint style="info" %}
**Consider currency differences.** Set thresholds in local currency for each market so they feel natural to customers.
{% endhint %}
{% hint style="info" %}
**Test international checkout.** Use a VPN or Shopify's preview mode to test how discounts appear in different markets.
{% endhint %}
{% hint style="warning" %}
**Markets must be active.** If you deactivate a market in Shopify, discounts targeting that market will stop working.
{% endhint %}
## When to Use Market vs Country
**Use Market when**:
* You have Shopify Markets configured
* You want to group multiple countries
* You need currency-aware thresholds
* You're managing regional strategies
**Use Country when**:
* You need country-specific rules
* You don't have Markets set up
* You want more granular control
* You're targeting individual countries
## Troubleshooting
Market not appearing in dropdown
* Verify Markets are configured in Shopify Settings
* Ensure the market is activated (not just created)
* Refresh the Advanced Free Shipping app
* Check your Shopify plan supports Markets
Discount not applying in specific market
* Confirm customer is actually in that market (check their currency/domain)
* Verify the market name matches exactly
* Test with a VPN or Shopify preview mode
* Check if other conditions are blocking the discount
Currency confusion with thresholds
* Remember: Cart total uses the market's currency
* Set thresholds appropriate for each market's currency
* Test with actual prices in that market
## Related Conditions
* [**Shipping Country**](/advanced-free-shipping/conditions-location/shipping-country.md) - More granular country-specific rules
* **Province/State** - Target specific regions within countries
* [**Cart Total**](/advanced-free-shipping/conditions-cart-and-order/cart-total.md) - Combine with value thresholds
* **Customer Tags** - Create market-specific VIP programs
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://responsive-media.gitbook.io/advanced-free-shipping/conditions-location/market.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.