Address formats by country
Each country has its own convention for structuring postal addresses. This tool
respects each country's format in the generated data:
Brazil
The Brazilian address follows the pattern: street type + name, number — complement
(optional) on the first line, neighborhood on the second, city and state (UF) on
the third, and CEP (8 digits, format NNNNN-NNN) on the fourth. The CEP is managed by the
Correios and its first digit indicates the country's macro-region. This tool respects
that regional division when generating the CEP — the first digit is always consistent
with the state.
Example output: Rua das Flores, 42 — Apto 101 / Jardim América / São Paulo — SP / CEP: 01310-450
United States
The American address follows the pattern: number + street name on the first
line, city, state abbreviation + ZIP Code on the second. The ZIP Code has 5
digits (format NNNNN) and is managed by USPS. In this tool, the generated ZIP only
follows the 5-digit format — there is no exact geographic link to the state.
Example output: 742 Oak Street / Austin, TX 78734 / United States
Portugal
The Portuguese address uses: street type + name, number on the first line, and
postal code + locality on the second. The Portuguese postal code has the format
NNNN-NNN (4 digits, hyphen, 3 digits) and is managed by CTT. The generated code only
follows the format — it is not linked to a real district.
Example output: Rua da Liberdade, 18 / 1250-096 Lisboa / Portugal
Spain
The Spanish address uses: street type + name + number on the first line,
postal code + city on the second and the province on the third. The
Spanish postal code has 5 digits, with the first two indicating the province (01 to 52).
The first two generated digits stay within that range, but the code is not checked
against the official database.
Example output: Calle Mayor 7 / 28013 Madrid / Madrid / España
United Kingdom
The British address uses: number + street name on the first line, the
city on the second and the postcode on the third. The British postcode
is alphanumeric with a variable format (e.g., SW1A 1AA, EC2V 8RF,
M4 3AB), made up of area (letters) + district (digits), a space, and sector +
unit (digit + 2 letters). The generated postcodes follow this visual pattern but are not
validated against the Royal Mail database.
Example output: 15 Victoria Street / London / SW1A 2JH / United Kingdom
Why are the cities real but the addresses fictitious?
The goal of this tool is to generate plausible addresses for software
testing. Real cities and states ensure the data passes city/state validations
present in many systems. On the other hand, it is not feasible to generate real streets
and numbers offline without an official database — which is not public and free for any
of the supported countries. Therefore:
- City and state/region: real, extracted from embedded datasets.
- Street (type + name) and number: fictitious — plausible random combinations.
- Neighborhood (Brazil only): fictitious — plausible generic names.
- Postal code: follows the country's format, but is not verified against any official database.
What is an address generator useful for in software testing?
- Filling registration forms in development and QA environments without exposing real data.
- Testing required-field validations, postal code masks and state/city selects.
- Populating test databases with varied records from different countries.
- Generating data for product demos and internationalized interface mockups.
- Testing integrations with freight, logistics and geolocation APIs using correctly formatted addresses.
- Validating multilingual and international address forms without using real customer data.
Frequently Asked Questions (FAQ)
Do the generated addresses really exist?
No. Only the cities and states/regions are real. The street, number and postal code are
fictitious — randomly generated within each country's format rules. Do not use this data
for real mail, shipping calculations, official registrations or any purpose beyond
software testing.
Are the generated postal codes geographically correct?
Not necessarily. They follow the country's format (number of digits,
presence of letters, separators), but are not linked to the real state or city. The only
partial exception is Brazil, where the first digit of the CEP is consistent with the
state's macro-region — but the remaining digits are random. For the US, Portugal, Spain
and the UK, the code only follows the country's visual pattern.
Why is the Brazilian CEP's first digit consistent with the state?
The Correios divide the country into 10 macro-regions based on the first digit of the
CEP (0 for Greater São Paulo, 9 for Rio Grande do Sul, etc.). This tool respects that
division to make the address more plausible — an address in Fortaleza will never have a
CEP starting with 9 (which belongs to RS). The remaining 7 digits are random.
Why isn't the US ZIP Code linked to the state?
That would require a database with the ZIP ranges per state, which is not fully public
and free. The generated ZIP follows the 5-digit format, which is enough to test masks
and format validations in forms.
Does the UK postcode follow the correct format?
It follows the visual pattern: area letters + district digits, space, and digit + 2 unit
letters (e.g., SW3 4BK, EC1V 9NB). The Royal Mail uses region-specific
variations that cannot be replicated offline without their proprietary database. The
generated postcode is enough to test format validations.
Can I generate several addresses at once?
Yes. Use the quantity selector to generate 1, 5 or 10 addresses at once — all from the
same selected country and region. Useful for quickly populating test tables with
multiple records.
What is the "complement" field and why does it only appear for Brazil?
The complement is optional information in the Brazilian address that identifies the unit
within the property (apartment, suite, block, back building, etc.). In the supported
English-speaking and Iberian countries, this information is usually part of the number or
street name in another way, or is omitted in the most common formats. For simplicity, the
complement field is available only for Brazilian addresses in this version.