Overview

The form builder in Customer Fields has an Address fields tab that contains all the fields you could possibly want to collect a physical address for your customers. Once this data is collected, it is saved into Shopify as the customer's default address. The customer can add a different first and last name to the default address, and they can also include a company name.

See the screenshot below to see where to find the address fields tab in the app's form builder. Notice there is a blue button at the bottom that you can use to automatically add all the standard fields, if needed.

Read more below to find detailed descriptions for each Address field


First name

Data column: default_address.first_name

This field can be used to collect the customer's first name for their address, which can be different from the first name for the customer record (see our help article on Standard Shopify fields for more details). The information from this field will be added to the customer's default address in Shopify.

Last name

Data column: default_address.last_name

Similar to the 'First name' field, the 'Last name' field can be used to collect the customer's last name for their address, which can be different from the last name for the customer record (see our help article on Standard Shopify fields for more details). The information from this field will be added to the customer's default address in Shopify.

Company

Data column: default_address.company

This is a single-line text field that will be added to the customer's company name in the default address section in Shopify.

Address line 1

Data column: default_address.address1

This is a single-line text field that collects the first line of the customer's default address, e.g. "123 Test Street".

Address line 2

Data column: default_address.address2

This field is used to collect the second line of the customer's default address, such as their apartment or suite number. It's usually a good idea to make sure this field is not required, in case it is not applicable to certain customers.

City

Data column: default_address.city

This single-line text field is used to collect the city for the customer's default address.

Zip/Postal code

Data column: default_address.zip

This single-line text field is used to collect the zip code (aka "postal code") for the customer's default address.

Country

Data column: default_address.country

This is a dropdown field that your customer can select a country from, which again is saved to the customer's default address.

This field's dropdown options are automatically determined based on your store's shipping zones, however if you want to show more options you can check "Show all countries". See the screenshot below for an example:

State/Province

Data column: default_address.province

This is a dropdown field that your customer can select their state (or province), again saving to the customer's default address.

The options in this field depend on the selection of the country field. If you don't have a Country field on the form, then there will be a new setting for 'Default country' that appears within the State/Province field that allows you to control what options are shown in the dropdown. See this screenshot for an example:

Example of address fields in Shopify

See the screenshot below of an example customer record in Shopify that has a full default address collected:

⚠️ Important note about address fields:

Shopify requires you to define a country for each default address. This means that if you don't have an actual 'Country' field on the form, but you intend to collect other address data (e.g. just 'Address line 1', or just 'Zipcode') you will get an error.

If for whichever reason you don't add a 'Country' field to your form, and you do not use the "Default country" setting for the 'State/Province' field, then you will need to specify the country of your choice using a form rule. You can do this by creating a new rule, using the Set field value action for the default_address.country data column. The value you set for this data column is your choice, but you'll want to make sure it's an actual valid country that Shopify's system is able to accept.

See the screenshot below for an example:

Questions, comments, or concerns?

Feel free to reach out to our support team via email or chat and we'll be happy to assist! 🤗

Did this answer your question?