Page MenuHomePhabricator

Account Creation form: Simplify username guidance based on experiment data and user research
Open, HighPublic5 Estimated Story Points

Description

As part of the English Wikipedia V2 Account Creation experiment, we updated the username helper text to:

Choose carefully - it's how the community will know you.

The expanded Username policy (TL;DR) panel also includes links to sections of the English Wikipedia username policy:
https://en.wikipedia.org/wiki/Wikipedia:Username_policy

image.png (1,920×1,298 px, 566 KB)

Problems

Early experiment results suggest that the overall Account Creation form improvements have increased account creation rates. However, very few users engage with the username guidance:
Fewer than 4% of users expand the username helper text.
Of those users, only a small percentage continue on to the full username policy. We should be sure that the username help text is as succinct as possible, but contains the most important information we want all new accounts to be aware of.

The current implementation also creates localization challenges. The TL;DR panel links to specific sections of the English Wikipedia username policy, but many wikis do not have equivalent sections or policy structures. This makes the content difficult to translate and maintain across Wikimedia projects.

Background

User testing (2026-04-30) found:

Nobody opened the 'Choose carefully' drawer. The link, which expands a panel with username policy guidance, was ignored by most participants. Those who did notice it didn't tap it. One participant (P9) explained they assumed it was a hyperlink that would navigate away from the page: 'I would have preferred just a little info button that I could tap and it pops up.' This combines with the form autopilot finding to point at a broader pattern: participants in familiar form flows don't read inline text, whether it's displayed openly or hidden behind a control. It's worth being direct about what this means for username policy communication - there's no strong evidence from this study (or past studies) that users will discover or read that guidance regardless of how it's presented.

This pattern holds across multiple studies: people move through familiar forms on autopilot and rarely read instructional text, whether it's visible or tucked behind an expandable control. Changing how the guidance is presented is unlikely to meaningfully increase engagement with it. What does matter is form length: the more text on the page ---> the longer the form appears ---> the less likely people are to complete the form.

Included as part of this task:
1. Improve the inline Username helper text

Community feedback suggests that the current copy ("Choose carefully") is vague and does not clearly communicate why usernames matter.

English Wikipedia is also discussing ways to ensure newcomers are aware that they may want to avoid using their real name:
https://en.wikipedia.org/wiki/MediaWiki_talk:Createacct-username-help

Suggestions include:

Avoid using your real name. (Why?)

or

Your username is public and cannot be made private later. Avoid using your real name. (Why?)

From a newcomer-friendly perspective, the helper text should be as clear, concise, and actionable as possible.

2. Reconsider how users access additional guidance

User research indicates that many participants assumed the expandable helper would navigate them away from the form, so they ignored it entirely.

Instead of using expandable helper text, consider an information icon or similar affordance that more clearly communicates that tapping it will display additional information without leaving the page.

  • text "Avoid using your real name."
  • add a codex icon-only small quiet button next to the codex field description
  • set the icon of the button to cdxHelpNoticeFilled
  • on tap the button opens a codex popover

image.png (1,780×1,880 px, 307 KB)


Acceptance Criteria:

Updated inline helper text is displayed
Given a user is on the account creation form
When the username field is rendered
Then the field description reads "Avoid using your real name."
(And the previous text "Choose carefully" is not present)

Help icon button is visible next to the username field description
Given a user is on the account creation form
When the username field is rendered
Then an icon-only quiet button using the cdxHelpNoticeFilled icon is displayed adjacent to the field description
And the button has an accessible label (e.g. "More information about usernames")

Tapping the help icon opens a popover
Given a user is on the account creation form
And the username help icon button is visible
When the user taps the help icon button
Then a Codex popover opens
And the popover contains username guidance content
And the user remains on the account creation form

Popover can be dismissed
Given the username help popover is open
When the user taps outside the popover or closes it
Then the popover closes
And the user remains on the account creation form with their progress intact

Popover provides access to open username policy
Given the username help popover is open
When the user taps on "Read the full username policy"
Then a new tab opens the associated wikis' username policy (Q4664077)
Example for enwiki: https://en.wikipedia.org/wiki/Wikipedia:Username_policy

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes

after an internal consulation, this is where we landed:

  • text "Avoid using your real name."
  • add a codex icon-only small quiet button next to the codex field description
  • set the icon of the button to cdxHelpNoticeFilled
  • on tap the button opens a codex popover

image.png (1,780×1,880 px, 307 KB)

the ? filled icon is currently not available in Codex but @DTorsani-WMF will add it in the next release.

KStoller-WMF set the point value for this task to 5.
KStoller-WMF added a subscriber: Trizek-WMF.

Note:

The current help text for the username field has been modified by some wikis. This help text (the text below the username field) will not longer display, we will now show a new field (above the username field) instead.

In a review of many wikis the modified field almost always shares the "username is public" or "don't use your real name" or other similar warning. Our hope is that our current design helps address the local customization.

Once that field name is finalized, let's make sure we add this news to TechNews so this isn't a surprise for our communities. @Trizek-WMF / @Sdkb

Michael triaged this task as Medium priority.Mon, Jul 13, 4:09 PM
Michael moved this task from Estimated tasks backlog to Needs Estimation on the Growth-Team board.
KStoller-WMF raised the priority of this task from Medium to High.Tue, Jul 14, 4:08 PM

Change #1311030 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/core@master] CreateAccount: make experimental username design the new default

https://gerrit.wikimedia.org/r/1311030

Change #1311475 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/extensions/GrowthExperiments@master] refactor: drop CreateAccount user-field experiment code

https://gerrit.wikimedia.org/r/1311475

Change #1311485 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/core@master] CreateAccount: use new error styles and live username validation

https://gerrit.wikimedia.org/r/1311485

Change #1311488 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/extensions/GrowthExperiments@master] refactor(CreateAccount): cleanup username normalization

https://gerrit.wikimedia.org/r/1311488

Change #1311838 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/extensions/WikimediaMessages@master] Drop no longer used message 'createacct-helpusername'

https://gerrit.wikimedia.org/r/1311838

Test wiki created on Patch demo by MGrosse-WMF using patch(es) linked to this task:
https://b3cb79eb5b.catalyst.wmcloud.org/w/

Change #1311488 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] refactor(CreateAccount): cleanup username normalization

https://gerrit.wikimedia.org/r/1311488

Change #1311475 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] refactor(CreateAccount): drop user-field experiment code

https://gerrit.wikimedia.org/r/1311475

Proposal for Tech News (User-notice):

On [DATE TDB], a new version of the username field on Special:CreateAccount will roll out that will feature a new version popover with a brief summary of the username policies. As part of that change, the messages createacct-helpusername and createacct-username-help that several communities have configured will no longer be used. Communities are being asked to adjust the messages in the popover createacct-username-policy-popover-bullet1, createacct-username-policy-popover-bullet2, and createacct-username-policy-popover-bullet3 to their needs instead.

What do you think @KStoller-WMF, @Sdkb?

Change #1311485 merged by jenkins-bot:

[mediawiki/core@master] CreateAccount: use new error styles and live username validation

https://gerrit.wikimedia.org/r/1311485

Looks good to me. I made some minor changes to the language to make it clearer that communities do not need to make any changes to those strings, but they can if they want.

User-notice
This will roll out with the release train next week.

On Thursday, July 23, a new version of the username field on Special:CreateAccount will roll out that will feature a new version popover with a brief summary of the username policies. As part of that change, the messages createacct-helpusername and createacct-username-help that several communities have configured will no longer be used. If communities want to customize the guidance shown in the new popover, they can instead edit the following messages: createacct-username-policy-popover-bullet1, createacct-username-policy-popover-bullet2, and createacct-username-policy-popover-bullet3.

Michael added a subscriber: Quiddity.

Looks good to me. I made some minor changes to the language to make it clearer that communities do not need to make any changes to those strings, but they can if they want.

User-notice
This will roll out with the release train next week.

On Thursday, July 23, a new version of the username field on Special:CreateAccount will roll out that will feature a new version popover with a brief summary of the username policies. As part of that change, the messages createacct-helpusername and createacct-username-help that several communities have configured will no longer be used. If communities want to customize the guidance shown in the new popover, they can instead edit the following messages: createacct-username-policy-popover-bullet1, createacct-username-policy-popover-bullet2, and createacct-username-policy-popover-bullet3.

I'm adding the tag so it actually shows up on the board.
@Quiddity, @STei-WMF (not sure whom to tag here): I'm not sure if this is a "highlight" in itself, but it is pretty important because these message have been modified by quite a few communities and some might have feelings about that, so we should make sure it is not buried somewhere deep between other messages.

I'm adding the tag so it actually shows up on the board.

Oh, whoops, thanks for catching that! I mistakenly thought using the tag in a comment automatically added the tag to the task.

Change #1311030 merged by jenkins-bot:

[mediawiki/core@master] CreateAccount: make experimental username design the new default

https://gerrit.wikimedia.org/r/1311030

@Michael Thanks for the catch,
Re: Who to ping - generally Sandister is the lead-editor these days, but there are a few backups people, so just mentioning Tech News within a comment (in a task tagged with user-notice) is usually sufficient/preferred.
Re: Timing - it's unfortunate that this is going to be announced the week after it launches, I.e. Gentle reminder to all, to consider the comms early on in the process. [Some people even recommend starting a project entirely, by writing the intended announcement text, and then working outwards from that!]
Re: current Draft - I recommend adding a link to the text (for the project page, which hopefully has a screenshot(s)), plus a short (phrase or sentence) addition to the first sentence to explain why this change is happening.

@Michael Thanks for the catch,
[...]
Re: Timing - it's unfortunate that this is going to be announced the week after it launches, I.e. Gentle reminder to all, to consider the comms early on in the process. [Some people even recommend starting a project entirely, by writing the intended announcement text, and then working outwards from that!]
[...]

Oops, I did not actually check that date. 😳 Thank you for pointing this out. The date is wrong, it launches the upcoming Thursday! (It was merged yesterday.) So the correct news entry would be:

On Thursday, July 30, a new version of the username field on Special:CreateAccount will roll out that will feature a new version popover with a brief summary of the username policies. As part of that change, the messages createacct-helpusername and createacct-username-help that several communities have configured will no longer be used. If communities want to customize the guidance shown in the new popover, they can instead edit the following messages: createacct-username-policy-popover-bullet1, createacct-username-policy-popover-bullet2, and createacct-username-policy-popover-bullet3.

@Michael @KStoller-WMF I have added the update to this week's edition and tweaked the tenses to reflect that it's already out, please check out the entry and make any changes needed: https://meta.wikimedia.org/wiki/Tech/News/2026/31

Change #1311838 merged by jenkins-bot:

[mediawiki/extensions/WikimediaMessages@master] Drop no longer used message 'createacct-helpusername'

https://gerrit.wikimedia.org/r/1311838

Thank you! Mea culpa ... I added the incorrect release date (even though I was aware the release date is next Thursday). Thanks for catching that!

Re: current Draft - I recommend adding a link to the text (for the project page, which hopefully has a screenshot(s)), plus a short (phrase or sentence) addition to the first sentence to explain why this change is happening.

@Quiddity Good point! I updated our project page with another image, and I've updated the Tech News draft with a clearer explanation and link to the project page. I also linked the "a popover summarizing the username policy" text directly to an example image on Commons.

@STei-WMF Feel free to update further as needed!

Change #1318074 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/core@master] CreateAccount: Use the new notice icon for username help

https://gerrit.wikimedia.org/r/1318074

(tiny code review needed for the newly available icon)

Change #1318074 merged by jenkins-bot:

[mediawiki/core@master] CreateAccount: Use the new notice icon for username help

https://gerrit.wikimedia.org/r/1318074

Change #1318125 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[mediawiki/core@master] CreateAccount: Remove unnecessary background-color

https://gerrit.wikimedia.org/r/1318125

Change #1318125 merged by jenkins-bot:

[mediawiki/core@master] CreateAccount: Remove unnecessary background-color

https://gerrit.wikimedia.org/r/1318125

Change #1319149 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/extensions/WikimediaMessages@master] SpecialCreateAccount: make user policy-link available again

https://gerrit.wikimedia.org/r/1319149

Change #1319149 merged by jenkins-bot:

[mediawiki/extensions/WikimediaMessages@master] SpecialCreateAccount: make user policy-link available again

https://gerrit.wikimedia.org/r/1319149

Change #1319449 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/extensions/WikimediaMessages@wmf/1.47.0-wmf.13] SpecialCreateAccount: make user policy-link available again

https://gerrit.wikimedia.org/r/1319449

Change #1319449 merged by jenkins-bot:

[mediawiki/extensions/WikimediaMessages@wmf/1.47.0-wmf.13] SpecialCreateAccount: make user policy-link available again

https://gerrit.wikimedia.org/r/1319449

Mentioned in SAL (#wikimedia-operations) [2026-07-30T13:32:14Z] <lucaswerkmeister-wmde@deploy1003> Started scap sync-world: Backport for [[gerrit:1319449|SpecialCreateAccount: make user policy-link available again (T430604)]]

Mentioned in SAL (#wikimedia-operations) [2026-07-30T13:49:56Z] <lucaswerkmeister-wmde@deploy1003> migr, lucaswerkmeister-wmde: Backport for [[gerrit:1319449|SpecialCreateAccount: make user policy-link available again (T430604)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2026-07-30T14:03:55Z] <lucaswerkmeister-wmde@deploy1003> Finished scap sync-world: Backport for [[gerrit:1319449|SpecialCreateAccount: make user policy-link available again (T430604)]] (duration: 31m 41s)

Test wiki on Patch demo by MGrosse-WMF using patch(es) linked to this task was deleted:

https://b3cb79eb5b.catalyst.wmcloud.org/w/

Change #1320165 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/core@master] CreateAccount: fix allowing links in community message overrides

https://gerrit.wikimedia.org/r/1320165

Change #1320165 merged by jenkins-bot:

[mediawiki/core@master] CreateAccount: fix allowing links in community message overrides

https://gerrit.wikimedia.org/r/1320165