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.

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.

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.

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.

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

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.

Data column: default_address.city

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

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.

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:

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:

Data column: default_address.phone

This field collects a phone number and attaches it to the default address in Shopify; this phone number is specific to the address that is collected for the customer, and is not to be confused with the standard phone field. The address phone number can be the same as the primary phone number on any other account, and does not have to be unique.

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

Shopify often requires that a value for country is defined 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'), then customers may get an error when trying to submit the form.

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 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:

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