Error addresses.country required

This error means your form is trying to create/update a Shopify customer address, but the Country value is missing. Shopify requires a country for customer addresses, so the request cannot be completed without it.

---

🔍 Why this happens

When you map address fields (like Address line 1, City, Province, Zip) to Shopify, Shopify expects a complete address.

If Country is not included, Shopify returns:

✅ addresses.country is required

Common causes:

• Your form does not have a Country field

• The Country field exists, but it is not mapped to Shopify

• The Country field is mapped, but users are leaving it blank

• The Country value is not in a format Shopify accepts

---

✅ How to solve it

If you don’t have a Country field: Use a Hidden field, set a fixed Country value (example: United States). Then map that field to Shopify.

⭐ Step 1: Create a Hidden field for Country

1. Open the app > click Forms > open the form you want to edit

2. Click Elements > Add element > select a Hidden element > Change the label of the field as your desire text

Customers can not see this field, only the admin can view this.

1. Assign the value as a particular country that you want to add on

4. Click Save

---

⭐ Map the hidden country field with Shopifycountry attribute

1. Open the app > click Forms > open the form you want to edit

2. Click Settings > Integration > turn on Shopify and click on Shopify option

1. Select the Hidden of the form on the left to map with Country of Shopify on the right

4. Click Save

Check out the result once more time on the form in the front-end site