Tool overview
What is a Test Address Generator?
A test address generator creates realistic mock street addresses across regions for forms, checkout flows, and QA.
Why use this Test Address Generator?
Fill multi-region address fields without using real PII—filter by country or subdivision and export JSON or plain text.
Key Features
Multi-country mocks, state/province filters, JSON or text export, and 100% client-side generation.
How to Use
Follow these steps to get accurate results from the tool interface above.
- Select a Country from the configuration panel (defaults to United States).
- Optionally choose a State / Province to constrain all records to one region, or leave All / Random Selection to sample across any subdivision in that country.
- Adjust the Quantity slider (1–100) to set how many address records are produced per generation run.
- Click Generate to refresh the dataset with new synthetic values while keeping your configuration.
- Switch between JSON Array and Plain Text output formats, then use Copy Output to export fixtures into your test suite or JSON Formatter.
Operational Technical Specifications
Postal fields are synthesized using region-aware formatting rules aligned with common localization patterns—no external address-validation SDK is bundled.
United States — ZIP Code Structure
US records emit five-digit numeric ZIP codes. When a specific state is selected, the first three digits are drawn from documented USPS prefix ranges for that state (e.g., California 900–961). With random state selection, prefixes follow the chosen state's allocation table.
Street lines use numbered thoroughfare patterns (123 Oak St) with common suffix abbreviations (St, Ave, Blvd, Dr).
Canada — Alphanumeric Postal Codes
Canadian postcodes follow the ANA NAN pattern (letter-digit-letter space digit-letter-digit). Letters exclude D, F, I, O, Q, and U per Canada Post addressing rules. Provinces map to full province names in the stateProvince field.
United Kingdom, Australia, Germany & France
UK postcodes use outward/inward segments (e.g. SW1A 1AA). Australian postcodes are four-digit numerics. Germany and France emit five-digit numeric PLZ / Code Postal values paired with localized city pools.
Country and subdivision labels reference ISO 3166-inspired region lists maintained in-browser—no CLDR or libaddressinput download occurs at runtime.
Output Field Contract
JSON mode returns an array of objects with streetAddress, city, stateProvince, postalCode, and country. Plain text mode repeats labeled blocks separated by blank lines for human-readable QA scripts.
Frequently Asked Questions
Expandable answers for common debugging bottlenecks and data privacy questions.
Related tools
Explore other related utilities that complement this tool.
Official Documentation & References
Authoritative specifications and platform documentation for this utility.