ShotMark
Skip to Content

Random Address Generator

Generate realistic addresses for test data.

Options

What is Random Address Generator?

A fake address generator is a tool that produces realistic-looking street addresses, complete with house number, street name, city, state, and ZIP code, for use as test data in forms, databases, and API fixtures. The output follows the United States Postal Service address format but does not correspond to real residences, so it is safe to use as filler without exposing private information.

This fake address generator builds each record in your browser from curated pools of street names, cities, US states, and ZIP ranges. QA engineers, frontend developers, and form designers use it whenever an address field needs plausible test data without the risk of pasting real customer details into a staging environment.

Why use a fake address generator?

  • Validate form behavior without real PII. Test address autocomplete, state pickers, and ZIP validators with data that looks real but is not tied to any person.
  • Seed databases for QA runs. Drop dozens of addresses into a staging seed script to populate user profiles, shipping records, or billing fixtures.
  • Stress-test layout for variable widths. Generated street names vary from short (“Oak Ave”) to long (“Washington Blvd”), which reveals truncation bugs in cards and tables.
  • Avoid copy-pasting real customer data. Production PII has no place in staging or screenshots. Generated addresses give you the format without the risk.
  • Stay private. All records are generated locally in your browser; no API call is made and no record is logged.

How to use the Address Generator

  1. Set the Count field to the number of addresses you need, from 1 to 50.
  2. Click Generate to produce the batch.
  3. Read the result as a tidy table of street, city, state, and ZIP.
  4. Click Copy to grab the entire batch as a JSON array, ready to paste into a fixture file or seed script.

A copied batch looks like this:

[ { "street": "742 Maple Dr", "city": "Springfield", "state": "Ohio", "stateAbbr": "OH", "zip": "44512" }, { "street": "1305 Lincoln Ave", "city": "Riverside", "state": "California", "stateAbbr": "CA", "zip": "92505" } ]

Output format

Each record is a JSON object with five fields. The street uses a number between 100 and 9,999 paired with a real-sounding street name. City and state names are drawn from common US municipalities and 29 US states. The ZIP code is a random 5-digit value between 10000 and 99999, which always matches the USPS 5-digit format even if the ZIP does not match the state in real geography.

FieldTypeExampleNotes
streetstring742 Maple DrHouse number 100-9999, common street suffix.
citystringSpringfieldOne of 20 generic US city names.
statestringOhioFull US state name.
stateAbbrstringOHTwo-letter US Postal Service code.
zipstring445125-digit ZIP, not guaranteed to match the state.

Test-data ethics

The output is fake. House numbers, street names, cities, and ZIPs are combined at random, so the result is statistically unlikely to match any real address. Even so, follow two rules:

  • Use generated addresses only in test, staging, or screenshot contexts. Never submit them to a live shipping API, a credit-card billing endpoint, or any system that will attempt delivery.
  • If by chance a generated address happens to match a real residence, treat the match as coincidental and discard the record. Never use generated data to send physical mail.

For more realistic, locale-aware fake data in CI fixtures, use the faker library on Node.js or Faker in Python; both run offline and offer per-country address formats.

Common use cases

  • QA engineers testing checkout forms. Generate 20 addresses to verify state dropdowns, ZIP validators, and address-line-2 handling across different combinations.
  • Frontend developers building shipping flows. Paste generated records into Storybook stories so address cards render with realistic word lengths.
  • Backend developers seeding user tables. Pre-populate a staging database with profile data so search, filter, and pagination behave like production.
  • Product designers prototyping account dashboards. Drop generated addresses into mockups so reviewers see realistic data density.
  • Security teams running red-team tests. Use plausible-but-fake addresses in phishing exercises and access reviews where real PII is forbidden.

Frequently asked questions

Are these addresses real?

No. Every record combines a random house number, a random street name, a random city, a random state, and a random ZIP. The combination is unlikely to match any real residence. Treat all output as fictional test data.

Is the data unique?

Across small batches, yes. Across very large batches (thousands of records), duplicates become possible because the underlying pools of street names and cities are finite. Deduplicate if your test depends on perfect uniqueness.

Does the ZIP match the state?

No. The ZIP is a random 5-digit number generated independently of the state. If your application enforces state-to-ZIP correlation (for example, in a real address validator), regenerate or hand-edit a record that fails.

Can I use this data in production?

No. Generated addresses are for testing only. Do not submit them to live shipping APIs, real payment processors, or any system that attempts physical delivery. They are also unsuitable for tax calculation, identity verification, or any compliance use case.

Why are all addresses in the United States?

The current pool covers US street formats, state codes, and 5-digit ZIPs. For non-US testing, use a country-aware library such as @faker-js/faker with the locale set to your target market.

How many addresses can I generate at once?

Up to 50 per batch. Click Generate repeatedly to grow the dataset, or use a library like faker for batches of hundreds to thousands inside a build script.

Are the addresses random each time?

Yes. Each click generates a fresh batch using Math.random over the curated pools. There is no fixed seed, so output is non-reproducible. For reproducible test data, pin a seed in a fixture generator instead.

Can I get city and state combinations that actually exist?

Not from this tool. The city and state are drawn independently, so the combination can be impossible (no “Springfield, Alaska” matching the famous show, for instance). Use a real-data library if your test asserts on geography.

Like this tool?

ShotMark captures what you do here, in one click.

The traces, payloads, and tests you run by hand? ShotMark grabs the whole bug and hands it to your AI agent.

Private beta accessFounding pricing lockNo spam ever