Address

Structured address entry with six fixed sub-fields — country, line1, line2, city, state, postalCode — and search-as-you-type autocomplete on the street-address line, proxied through the backend’s geocoder. Choosing a suggestion fills the enabled sub-fields; everything stays editable, and if the geocoder is down the suggestions simply don’t appear — manual entry always works.

Country is a searchable dropdown (249 entries, stored as ISO alpha-2 codes). When the country is US, the state field becomes a dropdown of the 50 states plus DC and territories (stored as two-letter codes), the postal-code label becomes “ZIP code”, and ZIP format is validated (12345 or 12345-6789). For any other country, state is free text and postal codes aren’t format-checked. Changing country clears the state.

Configuration

Option	Default	Notes
Enabled sub-fields	all six	country, line1, city are always enabled and can’t be disabled
Required sub-fields	all but line2	Marking one required auto-enables it
Default country	US	Pre-selected until the respondent changes it; “None” available
Address autocomplete	on	Turns geocoding suggestions off entirely

"typeConfig": {
  "enabledFields": { "line2": true, "state": true, "postalCode": true },
  "requiredFields": { "country": true, "line1": true, "city": true, "state": true, "postalCode": true },
  "defaultCountry": "US",
  "autocomplete": true
}

Stored answer

A flat object with exactly the enabled sub-fields as keys — untouched enabled fields as empty strings. A fully blank address stores nothing.

"homeAddr": {
  "country": "US",
  "line1": "12 Main St",
  "line2": "",
  "city": "Woodbury",
  "state": "NJ",
  "postalCode": "08096"
}

Country and US state are stored as codes ("US", "NJ"), which is also what CSV export and rules see.

Answered: every sub-field that is both enabled and required is non-blank.

In CSV export, an address expands into one column per enabled sub-field (homeAddr.city, homeAddr.state, …).

Rule operators

equals, not equals — always against a specific sub-field, chosen in the rule builder (a condition on “the whole address” doesn’t exist). For the country sub-field the value comes from the country list; for the state sub-field of a US-defaulted address, from the state list. A blank sub-field counts as unanswered and matches neither operator.