Format guide
US Address Format Guide
US address fields look simple, but production forms usually fail around small details: state abbreviations, ZIP code shape, city matching, optional ZIP+4 fields, and phone formatting.
This guide explains the address pieces GenAddr produces and shows how to use synthetic US address records for checkout tests, signup forms, imports, and QA automation.
What this adds beyond a basic address generator
Standard field order
Most US forms expect a street line, city, state abbreviation, ZIP code, and country.
- Street address line
- City
- Two-letter state code
- Five-digit ZIP code
- United States
Validation-sensitive fields
These fields should be tested together because validators often compare them.
- City and ZIP code
- State and ZIP code
- Phone area code
- CSV import column names
Consistency checks competitors usually skip
GenAddr keeps the fields in the same generated record aligned instead of mixing unrelated values.
- City and state stay together.
- ZIP code belongs to the selected city.
- Phone number uses a region-appropriate US format.
- Generated values are clearly marked as synthetic test data.
Example fields
- Street
- 11533 WESTVIEW PKY
- City
- San Diego
- State
- CA
- ZIP code
- 92126
- Phone
- +1 619 555 0184
Example JSON fixture
{
"street": "11533 WESTVIEW PKY",
"city": "San Diego",
"state": "CA",
"postalCode": "92126",
"country": "United States",
"phone": "+1 619 555 0184"
}Responsible use
- All generated data is synthetic and does not describe a real person, household, or account.
- Do not use it for fraud.
- Do not use it for identity verification.
- Do not use it for payment verification.
- Do not use it to impersonate real people.
- Use it only for testing, QA, demos, development, and education.
Frequently asked questions
What is the normal US address format?
A typical US address uses street address, city, two-letter state abbreviation, ZIP code, and country. Many forms also collect phone and email alongside the address.
Should I test city, state, and ZIP together?
Yes. Many bugs appear only when ZIP code, city, and state are validated together, so a realistic test record should keep those fields aligned.
Can I use these examples for real mail delivery?
No. The examples are synthetic test data for QA, development, demos, and education.