Country format
India Address Format Guide
Indian addresses can include building names, flat numbers, street names, locality, city, state, and a six-digit PIN code. Forms should allow more address lines than a simple street/city/postcode model.
Common layout
Aarav Sharma
Flat 402, Green Heights
MG Road, Indiranagar
Bengaluru, Karnataka 560038
India
Fields to support
- Recipient: person or business name.
- Building and flat: apartment, floor, tower, block, or building name.
- Street and locality: road, area, sector, layout, or neighborhood.
- City and state: locality and state are both important.
- PIN code: six digits.
QA notes
Test multiple address lines, long locality names, six-digit PIN codes, state dropdown behavior, and CSV exports that preserve line breaks and commas.
Field mapping
| Content | Suggested field | QA risk |
|---|---|---|
| Flat 402, Green Heights | Building / Line 1 | Comma must be quoted in CSV |
| MG Road, Indiranagar | Street and locality | Do not discard locality as duplicate city data |
| Bengaluru | City | Allow current and legacy place-name variants |
| Karnataka | State | Country switch should load Indian states |
| 560038 | PIN code string | Require six characters without testing deliverability |
Regression cases
- Address lines containing commas survive CSV round trips.
- Long building and locality values wrap without silent truncation.
- PIN code remains a string in JSON, spreadsheet, and database layers.
- State selection does not replace city or locality.
India Post describes PIN codes and postal services on its official website. Generated examples are not India Post-validated addresses.
Locality hierarchy test
Indian addresses may use a building or house, street, neighborhood, landmark, locality, district, city, state, and PIN code, but not every record needs every layer. Test the hierarchy without collapsing all place information into a single city value.
| Input | Store as | Failure signal |
|---|---|---|
| Indiranagar | Neighborhood or dependent locality | It overwrites Bengaluru. |
| Bengaluru | City / locality | It is replaced by the district or state. |
| Karnataka | Administrative area | A U.S.-only state abbreviation is required. |
| 560038 | PIN code string | The value is parsed as a number or reformatted. |
For a reproducible regression, submit the record with Address Line 2 empty, then repeat with a landmark in that field. Both versions should save successfully, and the landmark should remain optional rather than becoming part of postal-code validation. A six-digit shape check is useful for input feedback but does not prove delivery coverage.