> 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/province-state.md).

# Province/State

## Overview

The **Province/State** condition applies discounts based on the specific province, state, or region within the shipping address. This is perfect for targeting specific geographic areas within a country.

{% hint style="info" %}
This condition works with provinces (Canada), states (US), and similar administrative regions in other countries.
{% endhint %}

## Available Operators

* **Is one of**: Province/state is in your selected list.
* **Is not one of**: Province/state is NOT in your selected list.

## How It Works

When a customer enters their shipping address:

1. They select their country
2. They select or enter their province/state
3. Advanced Free Shipping checks if it matches your condition

{% hint style="info" %}
The dropdown shows provinces/states for all countries. Search by name or code (e.g., "California" or "CA").
{% endhint %}

## Common Use Cases

### State-Specific Free Shipping

**Free shipping for California orders**

**Configuration**:

* Condition: Province/state **is one of** California (CA)
* Discount: Free shipping

**Use case**: Local or regional promotions.

### Multi-State Free Shipping

**Free shipping for West Coast states**

**Configuration**:

* Condition: Province/state **is one of** CA, OR, WA
* Discount: Free shipping

### Exclude Expensive States

**Free shipping to continental US (exclude AK, HI)**

**Configuration**:

* Condition 1: Country **is one of** US
* Condition 2: Province/state **is not one of** AK, HI
* Condition 3: Cart total **is at least** $50
* Discount: Free shipping

{% hint style="info" %}
Alaska and Hawaii often have higher shipping costs. This is a common exclusion strategy.
{% endhint %}

### Canadian Provinces

**Free shipping for Ontario and Quebec**

**Configuration**:

* Condition: Province/state **is one of** ON, QC
* Discount: Free shipping

### Regional Promotion

**Summer sale for Southern states**

**Configuration**:

* Condition: Province/state **is one of** TX, FL, GA, LA, AL, MS, SC, NC, TN, AR
* Active dates: June 1 - August 31
* Discount: Free shipping

## Regional Strategies

{% tabs %}
{% tab title="Local Market Focus" %}
**Goal**: Prioritize your local state/province

**Discount 1** (Local):

* Province/state **is one of** CA
* Cart total **is at least** $30
* Discount: Free shipping

**Discount 2** (Regional):

* Province/state **is one of** OR, WA, NV, AZ
* Cart total **is at least** $50
* Discount: Free shipping

**Discount 3** (National):

* Country **is one of** US
* Cart total **is at least** $75
* Discount: Free shipping
  {% endtab %}

{% tab title="Exclude Remote Areas" %}
**Goal**: Free shipping except expensive regions

**Configuration**:

* Country **is one of** US
* Province/state **is not one of** AK, HI
* Cart total **is at least** $50
* Discount: Free shipping

**Separate discount for AK/HI**:

* Province/state **is one of** AK, HI
* Cart total **is at least** $100
* Discount: $20 off shipping
  {% endtab %}

{% tab title="Border States" %}
**Goal**: Free shipping near your warehouse

**Configuration**:

* Province/state **is one of** IL, IN, WI, MI, OH
* Discount: Free shipping

Perfect if your warehouse is in Illinois.
{% endtab %}
{% endtabs %}

## Combining with Other Conditions

### Province + Value

**Free shipping for Texas orders over $40**

* Condition 1: Province/state **is one of** TX
* Condition 2: Cart total **is at least** $40

### Province + Customer

**VIP customers get free shipping in all states**

* Rule Group 1 (VIP):
  * Condition: Customer tag **contains** "VIP"
* Rule Group 2 (Local):
  * Condition: Province/state **is one of** CA, OR, WA

### Province + Product

**Free shipping on local products to local customers**

* Condition 1: Province/state **is one of** CA
* Condition 2: Collection **contains** "California Made"

## US State Codes Reference

Common US states:

| State          | Code | State        | Code |
| -------------- | ---- | ------------ | ---- |
| California     | CA   | Texas        | TX   |
| Florida        | FL   | New York     | NY   |
| Illinois       | IL   | Pennsylvania | PA   |
| Ohio           | OH   | Georgia      | GA   |
| North Carolina | NC   | Michigan     | MI   |
| New Jersey     | NJ   | Virginia     | VA   |
| Washington     | WA   | Arizona      | AZ   |
| Massachusetts  | MA   | Tennessee    | TN   |
| Indiana        | IN   | Missouri     | MO   |
| Maryland       | MD   | Wisconsin    | WI   |

**Remote/Expensive states**:

* Alaska (AK)
* Hawaii (HI)

## Canadian Province Codes

| Province         | Code | Province             | Code |
| ---------------- | ---- | -------------------- | ---- |
| Ontario          | ON   | Quebec               | QC   |
| British Columbia | BC   | Alberta              | AB   |
| Manitoba         | MB   | Saskatchewan         | SK   |
| Nova Scotia      | NS   | New Brunswick        | NB   |
| Newfoundland     | NL   | Prince Edward Island | PE   |

**Remote territories**:

* Yukon (YT)
* Northwest Territories (NT)
* Nunavut (NU)

## Best Practices

{% hint style="info" %}
**Group by shipping zones.** If your carrier charges the same for multiple states, group them together.
{% endhint %}

{% hint style="info" %}
**Consider warehouse location.** Offer better shipping terms to states near your warehouse where costs are lower.
{% endhint %}

{% hint style="info" %}
**Exclude expensive regions thoughtfully.** If you exclude AK/HI, consider offering a partial discount instead of nothing.
{% endhint %}

{% hint style="info" %}
**Test with real addresses.** Use checkout preview with addresses in your target states to verify discounts work.
{% endhint %}

{% hint style="warning" %}
**Abbreviations matter.** Make sure customers enter state codes correctly. Most Shopify themes use dropdowns, which helps prevent errors.
{% endhint %}

## Province vs Country vs Postcode

| Condition    | Granularity    | Best For              |
| ------------ | -------------- | --------------------- |
| **Country**  | Entire country | National strategies   |
| **Province** | State/province | Regional strategies   |
| **Postcode** | Specific areas | Hyper-local targeting |

Use Province for regional targeting within a country. Use Postcode for even more specific areas.

## Troubleshooting

<details>

<summary>Discount not applying to expected state</summary>

* Verify the state/province is in your selected list
* Check if customer entered the state correctly
* Confirm the country is correct (CA = California or Canada?)
* Test with a known valid address

</details>

<details>

<summary>Discount applying to wrong states</summary>

* Review if you're using "is one of" vs "is not one of"
* Check for overlapping discounts
* Verify your state list is complete

</details>

<details>

<summary>Remote state exclusions not working</summary>

* Make sure you're using "is not one of" for exclusions
* Verify you included the country condition too
* Test with AK/HI addresses specifically

</details>

## Related Conditions

* [**Shipping Country**](/advanced-free-shipping/conditions-location/shipping-country.md): Target entire countries
* [**Postcode/ZIP**](/advanced-free-shipping/conditions-location/postcode-zip.md): Target specific postal codes
* [**Shopify Market**](/advanced-free-shipping/conditions-location/market.md): Regional market targeting
* [**Cart Total**](/advanced-free-shipping/conditions-cart-and-order/cart-total.md): Combine with value thresholds


---

# 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/province-state.md?ask=<question>&goal=<endgoal>
```

`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.