Page MenuHomePhabricator

Account Creation: UI and UX improvements for user-input form warning and error messages
Open, MediumPublicSpike

Description

Conduct a comprehensive audit of all error messages and warnings within the Account Creation flow, and update them to consistently use Codex styling.

Goals

Ensure all Account Creation errors and warnings use consistent Codex components and styling
[TBD] Reduce visual noise by consolidating multiple messages into a single, structured alert when appropriate

Scope
  • Username validation errors (unavailable, invalid format, TitleBlacklist, etc.)
  • Password validation errors
  • Password match validation errors
  • Email-related warnings or errors
  • [TBD] HCaptcha error messages
  • Any pre- or post-submit validation messaging

NOT in scope: IP Blocks and any other errors or warnings that don't relate to a user's input on this form.

Details from previous audit spike:

T414235: Engineering Research Spike: Account Creation form validation logic

Username

If username is already in use (πŸ›‘ error):

Username entered already in use. Please choose a different name.

If starting with a lowercase letter (⚠️ warning):

Your username will be adjusted to "<username with first letter uppercase>" due to technical restrictions.

If the username is too long (and probably some other reasons) (πŸ›‘ error):

You have not specified a valid username.

Password

If password is too short (πŸ›‘ error)::

Passwords must be at least 8 characters.

If password is too long (πŸ›‘ error):

Passwords cannot be longer than 4096 characters.

If password is the username (πŸ›‘ error):

Your password must not appear within your username.

If password is too common (πŸ›‘ error):

The password entered is in a list of very commonly used passwords. Please choose a more unique password.

Confirm password

If the passwords do not match (πŸ›‘ error):

The passwords you entered do not match.

Email

If the email is not valid (πŸ›‘ error):

The email address cannot be accepted as it appears to have an invalid format.
Please enter a well-formatted address or empty that field.

If email is too long (πŸ›‘ error):

Your email address should have at most 255 characters.

As soon as the email field receives focus and when something is entered (⚠️ warning):

Please look for an email from us to verify your address.

Other errors to consider:
(1) When a username matches the TitleBlacklist
(2) when a logged-in user creates a new account via Special:CreateLocalAccount page (details: https://phabricator.wikimedia.org/T414235#11809796)

Acceptance Criteria:
  • thorough audit of account creation form validation (errors and warnings that relate to user input)
  • (lightweight) documentation of learnings and recommendations

Event Timeline

KStoller-WMF triaged this task as Medium priority.
KStoller-WMF moved this task from Inbox to Needs Refinement on the Growth-Team board.
KStoller-WMF renamed this task from Account Creation: UI and UX improvements for warning and error messages to Account Creation: UI and UX improvements for user-input form warning and error messages.May 14 2026, 12:06 AM
KStoller-WMF updated the task description. (Show Details)
KStoller-WMF moved this task from Needs Refinement to Needs Estimation on the Growth-Team board.