Show a block by shipping country
In short
Open the block, turn on Enable conditional block visibility, and add a Shipping Country condition. Choose Is to show the block only for the countries you pick, or Is Not to hide it for them. The condition reads the delivery address, so it only matches once the buyer has entered a country.
✓ Applies to
- Advanced and Deluxe plans
- Any Checkout Ninja block, in any checkout position
- Shipping country and state or province of the delivery address
✕ Doesn't apply to
- Billing address, IP location or the buyer's market
- Showing a block in another language. That's done with translations
Before you start
- Create and save the block you want to control. See create a block.
- Decide between Is and Is Not. Is shows the block only for the countries you pick. Is Not shows it everywhere except those countries, including before a country is entered.
Steps
- In Checkout Ninja, go to Blocks and open the block.
- In the Block Visibility card, turn on Enable conditional block visibility.
- Click Add new visibility condition.
- In the Condition menu, choose Shipping Country.
- In the operator menu, choose Is or Is Not. Don’t leave it on ”-”.
- In Value, select one or more countries.
- Click Save.
Target a state or province
- Add a visibility condition and choose Shipping State / Province.
- Choose Is or Is Not.
- In State / Province Codes, type a code such as
CA,NYorONand press Enter. Repeat for each code. - Click Save.
Use the code, not the full name. The condition compares against the province code in the delivery address.
Several conditions on one block are combined with OR. A Shipping Country condition for the US plus a Shipping State / Province condition for ON shows the block for every US address and for Ontario. To narrow down, use a single condition.
Verify it worked
- Start a checkout and enter a delivery address in one of your countries. The block appears.
- Change the address to a country not in your list. The block disappears.
- Check the start of checkout, before any address is entered. With Is the block is hidden. With Is Not it shows.
Limitations
- The condition reads the delivery address only. It doesn’t use the billing address, IP location or Shopify Markets.
- Orders with no delivery address, such as local pickup, have no shipping country. Is never matches them.
- Conditions apply to the whole block. To show different content per country, create a block per country and place each one.
- You can’t combine a country with another condition as AND on the same block.
Troubleshooting
The block never shows. Check the operator isn’t left on ”-”. A condition without an operator never matches. Then check the buyer has entered a delivery address in one of the selected countries.
The block shows before the buyer enters an address. That’s how Is Not works: with no country yet, the address isn’t in your excluded list. Use Is with the countries you want instead.
The state condition doesn’t match.
Enter province codes, not names: CA, not California. Codes are matched exactly, so use capitals.
Frequently asked
Why doesn't my country block show at the start of checkout? +
Shipping Country reads the delivery address. Until the buyer has a country in that address, an Is condition doesn't match, so the block stays hidden.
Can I pick several countries in one condition? +
Yes. The country field accepts several countries. With Is, the block shows for any of them. With Is Not, it hides for all of them.
How do I target a US state or Canadian province? +
Use Shipping State / Province. Type each code, for example CA or NY, and press Enter after each one.
Can I show the block for a country and a product at the same time? +
Not with one block. A block with several conditions shows when any one of them matches, so conditions work as OR.