Merge pull request #2861 from alphagov/guidance-show-hide-password-da…

…c-audit Add guidance on show/hide password buttons
alphagov · Aug 9, 2023 · f8a19f4 · f8a19f4
2 parents ee49e19 + bd19f1d
commit f8a19f4
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/src/patterns/passwords/index.md b/src/patterns/passwords/index.md
@@ -69,6 +69,13 @@ To help users meet your password constraints and prevent mistyped passwords, you
 - show the last typed character of their password
 - make them enter their password twice and automatically compare them
 
+#### Showing and hiding passwords
+It's common for services to help users type passwords with a '[show password](https://github.com/alphagov/govuk-design-system-backlog/issues/240)' button to let users see their password if they want to.
+
+When there are two or more password fields on a page, the 'show' and 'hide' labels for each password input must be different.
+
+For example, you can label the input "Password" as "show password" and label the second input "Re-enter password" as "show re-entered password".
+
 ### Allow users to paste their password
 
 Do not disable paste on password fields. People may have very good reasons why they want to paste their password, for example if they’re using a password manager.