Have you ever started typing into a form and had your browser suggest a saved value? HTML can help the browser decide which value belongs in which field. The autocomplete token address-level1 is used for highest administrative region below a country.
What address-level1 tells the browser
Highest administrative region below a country.
This is a hint, not an instruction to fill a value automatically. Browsers and password managers consider settings, saved data, permissions and other signals before offering suggestions.
Example form field
<form action="/example" method="post">
<label for="detail-field">State or province</label>
<input id="detail-field" name="detail" type="text" autocomplete="address-level1">
<button type="submit">Continue</button>
</form>Understanding the example
The autocomplete="address-level1" attribute labels this field for autofill. Its visible <label> still tells people what to type, and its name attribute determines the key sent when a form is submitted.
The precise meaning changes by country.
Address formats differ widely by country. Keep optional fields truly optional and avoid strict assumptions about postcode length, district names or address ordering.
Try it yourself
Save the example as an HTML file, and test the field with browser autofill enabled. Inspect the autocomplete value and compare it with the field label. Browser behavior depends on available saved information, so a missing suggestion is not necessarily an HTML mistake.
Common Beginner Mistakes
- The precise meaning changes by country.
- Leaving out the visible label because the browser might autofill the field.
- Treating autofill suggestions as verified or safe data.
Key Takeaways
address-level1describes highest administrative region below a country.- The precise meaning changes by country.
- Autocomplete helps users; it does not replace labeling, accessibility or validation.