Content · Web Development · HTML

HTML new-password Autocomplete Token: Reference and Examples

Learn how to use autocomplete="new-password" in HTML forms with readable code, privacy notes and beginner tips.

1 views Published Oct 19, 2026 Updated Oct 19, 2026 Admin

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 new-password is used for password being created or changed.

What new-password tells the browser


Password being created or changed.

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">New password</label>
    <input id="detail-field" name="detail" type="password" autocomplete="new-password">
    <button type="submit">Continue</button>
</form>

Understanding the example


The autocomplete="new-password" 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.

Do not disable password managers; validate and hash passwords on the server.

Sensitive information deserves extra care. Use HTTPS, collect only what is needed, avoid logging secrets, and validate received data on the server. Payment card fields should generally use a compliant payment provider rather than custom storage.

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


  • Do not disable password managers; validate and hash passwords on the server.
  • Leaving out the visible label because the browser might autofill the field.
  • Treating autofill suggestions as verified or safe data.

Key Takeaways


  • new-password describes password being created or changed.
  • Do not disable password managers; validate and hash passwords on the server.
  • Autocomplete helps users; it does not replace labeling, accessibility or validation.
Share this resourceSend this page to someone who may find it useful.