# 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.

<figure><img src="/files/yjpXgLcVnZYbCrNl6vik" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/DJlf9zyGzLgMeK9eaiic" alt=""><figcaption></figcaption></figure>

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. &#x20;Click **Settings** > **Integration** > turn on Shopify and click on Shopify option

<figure><img src="/files/rE9aiksh8jRtfjFJS3cy" 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="/files/8hJL2OQoLHVnmk1cqWpg" alt=""><figcaption></figcaption></figure>

4\. Click **Save**

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

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerfulform.com/~/revisions/KRfi0fHdeAFeAhiPrH7G/trouble-shooting/error-addresses.country-required.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
