# Error: Address 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:

&#x20;**`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.

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FcH43rvkJONnZqAvuxooG%2F2025-10-07_14-50-49.png?alt=media&#x26;token=4b7869b3-eb12-4d73-a273-def7f74ea459" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FGf70BGhidDj0y9evqcwF%2F2025-10-07_14-51-08.png?alt=media&#x26;token=6e3a3801-33b2-41bf-b22a-11dd097725b0" alt=""><figcaption></figcaption></figure>

4\. Click **Save**

***

### 📝 Step 2: Map the hidden country field with Shopify country attribute

1. Open the app > click **Forms** > open the form you want to edit
2. &#x20;Click **Settings** > **Integration** > turn on **Shopify** > click on **Shopify** option

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FyBRF3GaaIntMYOmk2ZzT%2F2026-01-29_17-13-49.png?alt=media&#x26;token=49d262ec-47dc-4722-850e-8d11274ec59c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2Fey8JB3SctYBRZh9cZAoy%2F2025-10-07_14-51-38.png?alt=media&#x26;token=57cc3895-3883-4aae-92c7-637617e04bd7" alt=""><figcaption></figcaption></figure>

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 [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further.
