US Address Generator

How a US address is written

The USPS layout has three lines for a domestic letter: the delivery line (house number, optional pre-directional, street name, suffix, optional post-directional and unit), an optional second address line, and the last line with city, two-letter state code and ZIP code. The house number always comes first: 2417 N Willow Ave Apt 12. USPS Publication 28 lists the standard abbreviations — Ave, St, Rd, Blvd, Apt, Ste — and prefers upper case without punctuation on envelopes, although mixed case is fine in your database.

For international mail the country name goes on its own line at the bottom. Inside the US it is usually left off, which is why the generator lets you copy addresses with or without the country line.

ZIP code structure

A ZIP code is five digits. The first digit is a broad region (0 in New England and Puerto Rico, 9 on the West Coast, Alaska and Hawaii), the first three digits identify a sectional center facility, and the last two narrow it to a post office or delivery area. The optional ZIP+4 extension (78701-1234) identifies a block face, building or PO box range.

• Accept both 12345 and 12345-6789: ^\d{5}(-\d{4})?$.
• Never store ZIP codes as integers. Boston’s 02108 becomes 2108, and a spreadsheet import will quietly do the same. The generator includes New England cities so this bug shows up in your tests.
• A format-valid ZIP is not proof that it exists or matches the city; only the USPS address database knows that.

States, DC and territories

The state is written as its two-letter USPS code, not the full name: TX, CA, NY. A state drop-down needs at least the 50 states plus DC. If you ship to them, add the territories (PR, GU, VI, AS, MP) and the military codes AA, AE and AP, which are used with APO/FPO addresses instead of a city. Several city names exist in many states (Portland, Columbus, Kansas City, Washington), so never derive the state from the city.

Testing tips for US address forms

• Unit numbers: make sure Apt, Unit, Ste and # all survive your normaliser, whether users type them on line 1 or line 2.
• Directionals and numbered streets: 300 W 23rd St and 51 E Elm Ct should not be “corrected” into something else.
• Length: USPS lines can be long; a 30-character limit on the street field will truncate real addresses.
• Address autocomplete: generated addresses are synthetic, so an address-verification API should return “not found” — use that to test your fallback when verification fails.

What makes these addresses fictional

City, state and ZIP prefix are real, so validation rules and sales-tax lookups by ZIP behave realistically. The street line is assembled from generic words (Oak, Maple, Ridge…) and a random number, so it is not taken from any address list. A combination can still match a real street by coincidence, which is why the data must only be used in test systems — never to sign up for services, ship goods or impersonate anyone.

States of United States

The generator uses the 51 first-level states below, with the codes used in addresses. Cities are picked from 24 places spread across the country, each with postcodes from its own range.

Example United States test addresses

Validation pattern used for the ZIP code: ^\d{5}(-\d{4})?$. It checks the format only — whether a code is actually in use is known only to the postal operator.

Phone numbers in United States test data

US numbers have a 3-digit area code, a 3-digit exchange and a 4-digit line number, written (512) 555-0123 or +1 512 555 0123. The generator only uses 555-0100 to 555-0199, the block the North American Numbering Plan Administrator keeps for fictional use, with the city’s real area code.

Source: NANPA – 555 line numbers (checked October 2026). All ranges: test e-mail addresses and fictional phone numbers.

Sources

• ISO 3166-2:US (states and DC)
• ZIP Code structure
• NANPA – 555 line numbers

Postcode ranges, region lists and address conventions checked against these sources in October 2026. Street names in the generator are synthetic.

Other countries: United KingdomCanadaAustraliaIndiaGermanyFranceSpainItalyNetherlandsBrazilMexicoJapanPhilippinesPakistanNigeriaSouth AfricaTurkeyIndonesiaUnited Arab Emirates