What are Mailchimp address fields, and how do they work?

Mailchimp address fields are special nested fields designed to capture full address details. These fields are not standalone fields. Instead, they are structured in a nested format like `ADDRESS.addr1`, `ADDRESS.city`, `ADDRESS.state`, `ADDRESS.zip`, and `ADDRESS.country.`

Note: All merge fields of type "Address" follow this same nestedpattern, even if you create custom merge fields.

Restrictions:

To populate or edit any Mailchimp merge field of type Address, you must provide values for `addr1`, `city`, `state`, and `zip`.

If the country field is not specified, it defaults to USA or your country.

When syncing, if you do not provide data for all the required nested fields, the entry might be considered incomplete, which could lead to errors. To correct, ensure that all required nested fields are populated and properly formatted, or consider the workaround below.

Workaround:

You can create your own custom merge fields that are the Text data type (instead of Address type), such as `MMERGE5` Street, `MMERGE6` City, etc.

Related topics: 

Data Wizard results

Preview Field Mapping results

Related Articles