Use email address as username

Question

Is there a specific or preferred way to set the username for new user registrations to be their email address?

At the moment my user signup form contains both fields:

<!-- Username -->
  <label for="username">Username</label>
    <input type="text" id="username" name="username" placeholder="joesmith" {%- if account is defined %} value="{{ account.username }}"{% endif -%}/>
    {% if account is defined %}
        {{ _self.errorList(account.getErrors('username')) }}
    {% endif %}

<!-- Email -->
  <label for="email" >Email</label>
    <input type="text" id="email" name="email" {%- if account is defined %} value="{{ account.email }}"{% endif -%}/ autocapitalize=off autocorrect=off>
    {% if account is defined %}
        {{ _self.errorList(account.getErrors('email')) }}
    {% endif %}

score 18 · Accepted Answer · edited Jun 20 '19 at 20:59

18

I believe you're looking for the conveniently named useEmailAsUsername config setting.

When that is set to true, any new user that is saved with a valid email address will have that copied over to the username field as well.

edited Jun 20 '19 at 20:59

Mike

277
2
10

answered Jul 23 '14 at 18:36

Brad Bell

67,440
6
73
143

1

Now all you need to do is mark it as the answer. :P – Brad Bell Jul 23 '14 at 18:45
2

This made me weep with joy. So convenient and smoothly implemented. – Ray Oct 07 '14 at 16:48
This is just what I needed. It would be nice if it was documented on the User registration form page in the docs. https://docs.craftcms.com/v3/dev/examples/user-registration-form.html – Tim Print Jul 11 '19 at 10:41
Added a note to that page @TimPrint. – Matt Stein Oct 10 '20 at 20:38

Use email address as username

1 Answers1