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.
Assign the value as a particular country that you want to add on
4. Click Save
📝 Step 2: Map the hidden country field with Shopify country attribute
Open the app > click Forms > open the form you want to edit
Click Settings > Integration > turn on Shopify and click on Shopify option
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
Need More Help?
If you still need assistance, please contact us at [email protected]. Our team will be happy to help you resolve any issues or guide you further.
Last updated