> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/troubleshooting/address-country-required.md).

# Error: Address country required

Fix the 'address country is required' error when creating a Shopify customer.

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.

## How to set it up

{% stepper %}
{% step %}

### 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://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-2f84246826671a8fa32d191f9da41702399de306%2Fscreenshot-ts-trouble-shooting-error-address-country-required-1.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-c1d697a8af2244fd8b103b9b219a6d0e22be5818%2Fscreenshot-ts-trouble-shooting-error-address-country-required-2.png?alt=media" alt=""><figcaption></figcaption></figure>

4\. Click **Save**
{% endstep %}

{% step %}

### Map the hidden country field with Shopify country attribute

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

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-c815f29546883468f6fb96ec90d519dd56b438c4%2Fscreenshot-integration-shopify-marketing-consent-4.png?alt=media" 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://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-5d726ecacaa2493a113b87423ff09402f16f222d%2Fscreenshot-ts-trouble-shooting-error-address-country-required-4.png?alt=media" alt=""><figcaption></figcaption></figure>

4\. Click **Save**

Check out the result once more time on the form in the front-end site
{% endstep %}
{% endstepper %}

<br>

## Next steps

* [Shopify Customers integration](/customers-and-registration/customer-fields.md) — where the address mapping lives.
* [Error: Customer already exists](/troubleshooting/customer-already-exists.md) — the same class of error.
* [Contact support](/help/contact-support.md) — if the problem is still there.
