Random Address Generator
The random address generator builds US-format addresses in 12 made-up towns such as Testville, so none of them is a real place. Choose up to 50 addresses and a layout, then press Generate.
Updated
How the random address generator builds an address
Each part is drawn on its own, so the ZIP code is not matched to the state or the town. The state codes and street types follow the USPS list of state abbreviations and its street suffix list, which is why the result looks right on a form.
| Part | Example | Where it comes from |
|---|---|---|
| House number | 418 | A random whole number from 1 to 9999. |
| Street | Sample Street | One of 12 placeholder names (Sample, Example, Placeholder, Demo and so on) and one of 8 street types. |
| Unit | Apt 12 | Added to about one address in five. |
| Town | Testville | One of 12 invented towns. |
| State | OH | One of the 50 state codes or DC, each with a 1 in 51 chance. To draw a state on its own, use the random state generator. |
| ZIP code | 30671 | Five random digits from 00001 to 99999, not matched to the state. |
Put together, with a name added, the example reads:
Lina Okafor
418 Sample Street, Apt 12
Testville, OH 30671
What fictional US addresses are good for
- Form testing: check that your address fields accept, store and display each part correctly.
- Mock-ups and screenshots: fill an invoice, a profile page or a shipping label with something that is obviously not a customer's data.
- Sample databases: seed a development database without copying production records. The test data generator builds whole rows with an email and a fictional 555 phone number next to each address.
- Fiction and games: give a character an address nobody lives at. For a more natural sound, try the street name generator and the town name generator.
Questions about the random address generator
Are these real addresses?
No, and they are built not to be. The town is always one of 12 invented names such as Testville, Sampleton or Placeholder Falls. No mail can be delivered to them.
Why not use real cities and matching ZIP codes?
A random house number on a common street in a real city is often somebody's home. Test data gets copied into demos, screenshots and sometimes real mailings.
A household should not receive post or visitors because a generator picked its address. Invented towns avoid that.
Will they pass address validation?
They pass a format check: street line, town, two-letter state code, five-digit ZIP. They fail a check against real postal data. The state code is a real one, but the ZIP is five random digits and is not matched to the state.
Can I use one as my own address on a form?
Not where a real address is required. Giving a false address for billing, shipping, identity checks or official forms can break a site's terms or the law. These addresses are for testing software and for fiction.
Are other countries supported?
Not at the moment. The earlier versions of this page built Canadian, British and Australian addresses from real cities and postcode districts; we removed them for the reason above and have kept one format we can describe exactly.
Sources
- USPS Publication 28: State abbreviations — the two-letter codes for the states and DC (checked October 16, 2026)
- USPS Publication 28: Street suffix abbreviations — the standard street types and their abbreviations (checked October 16, 2026)