Page MenuHomePhabricator

[V1 test] Redesign mobile web account creation form following Codex guidelines
Closed, ResolvedPublic

Description

User story & summary:

As a mobile web user, I want a cleaner and less verbose account creation form so that I can view all required fields at a glance without scrolling, and complete registration with reduced information overload.

Background & research:

This task is important because the current account creation form on mobile web presents multiple usability challenges. On relatively small devices (eg. iPhone 13 Mini), users cannot see the entire form without scrolling, making it difficult to understand the full scope of required information at a glance. Additionally, the form contains redundant elements and verbose helper text that increase information density and cognitive load - particularly problematic on mobile where the keyboard often covers half the screen.

A comparative analysis of the top 20 most visited websites (T410558) reveals that most platforms use multi-step account creation forms (often one field per view) to simplify information overload. While a full multi-step redesign is beyond the scope of this task, these changes represent a first step toward a simpler, cleaner experience by following Codex design system guidelines, removing redundant elements, and improving information hierarchy.

Design:

https://www.figma.com/design/mEYvnTEoCHGLavr3g7Jjs2/T409236-account-creation?node-id=59-3345&t=Z27cRJc9WSuEO1Nv-1

BeforeAfter
Claude 2026-01-27 12.36.58.png (750×3,430 px, 392 KB)
Arc 2026-01-27 12.37.02.png (750×2,024 px, 217 KB)
Acceptance Criteria:
  1. Remove the "Wikipedia is made by people like you. Log in to contribute." message from the top of the form
  2. Remove the Wikipedia globe (project logo) between the page title and username field
  3. Move "(username policy)" link into the username field description as "Learn more" within the text "Your username is public and cannot be made private later. Learn more"
  4. Move all field helper texts to be field descriptions displayed above input fields, per Codex guidelines
  5. Replace password field description with helper text "Passwords must be at least 8 characters" displayed below the input field
  6. Change email field label from "(recommended)" to "(optional)" using the Codex field component optional indicator prop
  7. Move hCaptcha disclaimer to appear immediately below the "Create your account" button
  8. Increase "Create your account" button size using Codex Button component large size prop
  9. Remove the "Wikipedia is made by people like you." section with statistics below the main button
  10. All existing campaign-specific benefits blocks for example: https://thankyou.wikipedia.org/wiki/Thank%20You/en?country=IN must be removed
  11. Remove the warning message "Please look for an email from us to verify your address." that is displayed on focus of the email address field.
  12. Autocapitalize usernames and swap underscores _ with spaces automatically

All tasks should also meet the Growth Team’s task completion definition.

Related Objects

Event Timeline

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

Hi, I would like to work on this task. I have reviewed the acceptance criteria and the design mockups. Could you please assign this to me?

Thank you for your enthusiasm and your initiative, but unfortunately this task is not suitable for a new contributor. Instead, have a look at these tasks, they might be a good place to get started: https://phabricator.wikimedia.org/maniphest/query/jsySdXllltwv/#R

KStoller-WMF renamed this task from Redesign mobile web account creation form following Codex guidelines to [V1 test] Redesign mobile web account creation form following Codex guidelines.Feb 3 2026, 6:13 PM

building off a past convo on "designing for curios people" i'd like to suggest another small change @KStoller-WMF. instead of adding a "learn more" link at the end for the username field description we could directly link the word "public".

Original proposalregular varianbold variant
image.png (750×1,624 px, 257 KB)
image.png (750×1,624 px, 255 KB)
image.png (750×1,624 px, 255 KB)

i'm leaning more towards the bold variant as it creates a visual connect between the field label "username" and the link "public".

I think the bold variant makes sense, provided we follow up soon, for example in V2 designs, to ensure the link opens a short, plain language summary of the key points rather than directing users immediately to a long and overwhelming policy page.
For example:

Username Policy
When choosing a username, avoid names that could be offensive, misleading, disruptive, or promotional.
Your username should represent a single individual, not an organization or group.
You may use your real name if you choose, but you should understand the potential privacy risks before doing so. Learn more.

Even in our first informal user test, it was clear that the English Wikipedia username policy page is overwhelming and confusing. Once the participant saw how long and dense the policy was, they did not attempt to read it. This reinforces the need for a short, accessible summary at the point of decision, with the full policy available only as a secondary reference.

totally @KStoller-WMF!

we don't have (yet!) a mobile variant for the codex popover - see T386144 and slack convo - but it could work well here!

image.png (750×1,624 px, 258 KB)

  1. Remove the "Wikipedia is made by people like you." section with statistics below the main button

There's at least one Growth feature that depends on the existence of the so-called benefits block, see Extension:GrowthExperiments/Technical_documentation#Campaigns. What should we do about this? cc @KStoller-WMF @Michael

  1. Remove the "Wikipedia is made by people like you." section with statistics below the main button

There's at least one Growth feature that depends on the existence of the so-called benefits block, see Extension:GrowthExperiments/Technical_documentation#Campaigns. What should we do about this? cc @KStoller-WMF @Michael

@Sgs has the team ever used this? do we have examples? would love to learn more about it!

coming back to your question - anything that lives under the main call to action "create your account" comes with the either the risk of being a distraction, or being likely invisible. that said, the proposed design is suggesting to hide this block as part of the experiment but i wouldn't exclude that we could use this block in the future. said otherwise, the feature can stay there - in code - but we would not use it for this task. or am i missing something here?

All existing campaign-specific benefits blocks must continue to work as usual, for example: https://thankyou.wikipedia.org/wiki/Thank%20You/en?country=IN

@KStoller-WMF @Michael JFYI specifically the block that is linked in our phab task description has some content issues - the 3 "bullet items" are missing on mobile

DekstopMobile
CleanShot 2026-02-18 at 19.15.48@2x.png (3,364×2,070 px, 695 KB)
Screenshot_1771438402.png (1,280×2,856 px, 420 KB)

the 3 "bullet items" are missing on mobile

Yikes.
Either we should create a bug report to fix this, or we need to stop showing the benefits block on mobile.

All existing campaign-specific benefits blocks must continue to work as usual, for example: https://thankyou.wikipedia.org/wiki/Thank%20You/en?country=IN

@KStoller-WMF @Michael JFYI specifically the block that is linked in our phab task description has some content issues - the 3 "bullet items" are missing on mobile

DekstopMobile
CleanShot 2026-02-18 at 19.15.48@2x.png (3,364×2,070 px, 695 KB)
Screenshot_1771438402.png (1,280×2,856 px, 420 KB)

the 3 "bullet items" are missing on mobile

Yikes.
Either we should create a bug report to fix this, or we need to stop showing the benefits block on mobile.

Looking into it, it was explicitly configured that way: See the config that has 'showBenefitsList' => 'desktop', - but maybe that was unintentional, or copied from something old? The link on the "Create an account" makes it seem like it came originally from the Thank You campaign for India in 2022, but maybe that was copy-and-paste too...

The code that makes that possible as added for T305659: Account creation: Thank You Page landing pages by @Sgs.

And the config there has been unchanged at least since 2023. Is https://thankyou.wikipedia.org even still used by anyone in fundraising or similar? Or is it just another left-over that we should get rid of?

And the config there has been unchanged at least since 2023. Is https://thankyou.wikipedia.org even still used by anyone in fundraising or similar? Or is it just another left-over that we should get rid of?

@spatton - We identified a bug affecting the “benefits” block on the mobile Account Creation page, which I believe is still linked from the Thank You page shown to donors.

  1. Can you help confirm for me: are we still using the campaign=typage parameter when sending donors to account creation?
  2. Do you have a perspective on whether this dedicated “benefits” block is necessary, versus sending donors to the standard account creation form?
  3. To your knowledge, was this experience ever A/B tested? My understanding is that we assumed the benefits framing would improve donor to account holder to editor conversion, but I do not believe we validated that assumption through experimentation. Does that align with your understanding?

@AAlhazwani-WMF, I'm curious, what was the thinking behind changing (recommended) to (optional) for the email address? It's easier to communicate with users who provide their email address (since someone who doesn't notice the alert notification for a warning on their talk page might still notice the email that I think (?) is also sent by default), so I'd think it's something we'd want to encourage.

@Michael FYI after chatting with @KStoller-WMF we decided to add this new acceptance criteria

  1. Remove the warning message "Please look for an email from us to verify your address." that is displayed on focus of the email address field.

@Michael FYI after chatting with @KStoller-WMF we decided to add this new acceptance criteria

  1. Remove the warning message "Please look for an email from us to verify your address." that is displayed on focus of the email address field.

Sounds good 👍

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

[mediawiki/extensions/GrowthExperiments@master] [DNM]: v1 Special:CreateAccount improvements

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

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

I created a patch-demo to show the status quo: https://776f2cc0f0.catalyst.wmcloud.org/w/index.php?title=Special:CreateAccount&returnto=Main+Page&mobileaction=toggle_view_mobile

It has:

Done:

  • 1. Remove the "Wikipedia is made by people like you. Log in to contribute." message from the top of the form
  • 2. Remove the Wikipedia globe (project logo) between the page title and username field
  • 4. Move all field helper texts to be field descriptions displayed above input fields, per Codex guidelines
  • 6. Change email field label from "(recommended)" to "(optional)" using the Codex field component optional indicator prop
  • 9. Remove the "Wikipedia is made by people like you." section with statistics below the main button
  • 10. All existing campaign-specific benefits blocks must continue to work as usual, for example: https://thankyou.wikipedia.org/wiki/Thank%20You/en?country=IN
  • 11. Remove the warning message "Please look for an email from us to verify your address." that is displayed on focus of the email address field.

The following are only partially done:

  • 3. Move "(username policy)" link into the username field description as "Learn more" within the text "Your username is public and cannot be made private later. Learn more"
    • need to think about this more. It should be doable, but we may need to get creative

Not done yet:

  • 5. Replace password field description with helper text "Passwords must be at least 8 characters" displayed below the input field
    • this text is pretty Wikimedia-specific, we can do it with a WikimediaMessages override, but we will also want a generic text
  • 7. Move hCaptcha disclaimer to appear immediately below the "Create your account" button
    • I think we decided to not do that after all
  • 8. Increase "Create your account" button size using Codex Button component large size prop
    • There is a bug in the Codex variant of HTMLForm that is a blocker here. Need to figure out how to best fix it.

Hi @KStoller-WMF, just following up on these questions from you below:

  1. Yes we still use the campaign=typage parameter when sending donors to account creation, e.g. on our U.S. Thank You page the Try editing Wikipedia hyperlink includes campaign=typage-in-en-2022
  2. In my perspective, it's a nice bit of personalization, but not required.
  3. To my knowledge, it wasn't A/B tested. I'd agree with how you describe our assumption that it'd be helpful, but it wasn't validated.

And the config there has been unchanged at least since 2023. Is https://thankyou.wikipedia.org even still used by anyone in fundraising or similar? Or is it just another left-over that we should get rid of?

@spatton - We identified a bug affecting the “benefits” block on the mobile Account Creation page, which I believe is still linked from the Thank You page shown to donors.

  1. Can you help confirm for me: are we still using the campaign=typage parameter when sending donors to account creation?
  2. Do you have a perspective on whether this dedicated “benefits” block is necessary, versus sending donors to the standard account creation form?
  3. To your knowledge, was this experience ever A/B tested? My understanding is that we assumed the benefits framing would improve donor to account holder to editor conversion, but I do not believe we validated that assumption through experimentation. Does that align with your understanding?

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

[mediawiki/core@master] HTMLForm: support field descriptions

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

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

[mediawiki/core@master] HTMLForm: add optional (optional) flag for codex fields

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

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

[mediawiki/core@master] HTMLButtonField: allow setting codex size keywords

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

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

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

This patch-demo shows all functional requirements (except 7) implemented: https://f68d909164.catalyst.wmcloud.org/w/index.php?title=Special:CreateAccount&returnto=Main+Page&mobileaction=toggle_view_mobile

Next steps will be to get the prerequisite changes reviewed and merged and to get the code of this change into a mergable state.

Change #1240748 merged by jenkins-bot:

[mediawiki/core@master] HTMLForm: support field descriptions

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

Change #1242356 merged by jenkins-bot:

[mediawiki/core@master] HTMLForm: add optional (optional) flag for codex fields

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

Change #1245371 merged by jenkins-bot:

[mediawiki/core@master] HTMLButtonField: allow setting codex size keywords

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

@KStoller-WMF @Michael based on our meeting i've updated those two acceptance criteria

  1. All existing campaign-specific benefits blocks for example: https://thankyou.wikipedia.org/wiki/Thank%20You/en?country=IN must be removed
  1. Autocapitalize usernames and swap underscores _ with spaces automatically

for 12. i've recorded a video to display the interaction:

  • auto-capitalization
    • while typing: when the user types a second character, the first character is auto-capitalized
    • on blur: if the first character is lowercase, it is auto-capitalized when focus leaves the field
  • underscore handling
    • while typing: an underscore typed in a middle position (not first, not last) is replaced with a space
    • while typing: an underscore typed as the first character is removed (no replacement)
    • on blur: if the first character is an underscore, it is removed
    • on blur: if the last character is an underscore, it is removed

I like that screenshare! There seem to be various other technical restrictions on usernames listed at this page. If we have the capacity, it might be nice to handle some of the other ones in a similarly elegant way.

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

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

https://2b257c7696.catalyst.wmcloud.org/w/

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

https://776f2cc0f0.catalyst.wmcloud.org/w/

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

The associated change is now ready for review for real.

Change #1243893 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] experiment: Special:CreateAccount improvements V1

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

When not logged-in on beta en-wiki, then the functionality can be verified with this link: https://auth.wikimedia.beta.wmcloud.org/enwiki/w/index.php?title=Special:CreateAccount&mobileaction=toggle_view_mobile&mpo=we-1-8-account-creation-form-v1:treatment

Note expected differences:

  • there is an extra message showing at the top, that is due to the (signupstart) message being overridden locally. By default, that message is empty.
  • the captcha is showing, that will also not be the case on enwiki because that uses hcaptcha

Follow-up instrumentation work will take place in T419916.

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

[mediawiki/extensions/GrowthExperiments@master] fix: do not duplicate username description as help-text

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

Change #1260040 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] fix: do not duplicate username description as help-text

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

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

[mediawiki/extensions/GrowthExperiments@master] feat: ensure Create Account experiment is enwiki only

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

Change #1266297 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] feat: ensure Create Account experiment is enwiki only

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

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

https://367983b56e.catalyst.wmcloud.org/w/

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

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