Enabling users to change their email address

On November 30th, 2016, Mozilla shut down the persona.org services. Persona.org and related domains will soon be taken offline.

For more information, see this guide to migrating your site away from Persona:


Because in Persona usernames are email addresses, it's not obvious how you can let your users change their email address. We're working on improving the flow for this and at the moment it is a little awkward, but it is possible if you follow these steps:

  1. Use an identifier that's independent of the user's email address as a primary key in your internal user table. This can then stay the same when the email address changes.
  2. Allow users to add email addresses to their account. You'll need to verify the email addresses, which you can do either manually, by sending an email to the new address containing a verification link, or by using Persona itself. If you use Persona to add email addresses, read Adding extra email addresses with Persona.
  3. Let users sign in with any email in their account.
  4. Let users delete email addresses.

With these features, users can change their email address like this:

  1. log into their account using their existing email address
  2. add the new email to their account
  3. remove the old email from their account