1. About MDN
    1. About MDN
    2. MDN reader's guide
    3. Promote MDN
    4. Send feedback about MDN
  2. Get started on MDN
  3. Help improve MDN
    1. Help improve MDN
    2. Things you can do
    3. Localizing MDN
    4. MDN editor UI
    5. Tools for power users
    6. Guidelines
    7. Work processes
    8. Content structures
  4. Kuma: MDN's wiki platform
  5. Join the MDN community
  6. Doc status by topic
    1. Doc status by topic
    2. Are we documented yet?

All users who wish to contribute to MDN must add a GitHub login to their MDN account in order to edit. This article describes how to add GitHub authentication to your MDN profile.

Note: Support for Persona logins on MDN was disabled on November 1, 2016. The method for adding a Github account to your profile therefore no longer works. If you didn't add a GitHub login to your MDN account before we disabled Persona logins, please file an "Account Help" bug on Bugzilla. For further reading about the end of life of Persona, see: Persona shutdown guidelines.


Adding GitHub authentication to your account isn't hard to do. We'll go into it in detail in a moment, but first, here's a quick list of the steps involved:

  1. Click the Sign in button to attempt to sign in to MDN.
  2. If you've already added a GitHub login to your MDN account, the GitHub authentication process will take place and then you'll be logged in to MDN.
  3. If you haven't added a GitHub login to your MDN account, you'll be asked to add one. See Setting up GitHub authentication below.

Detailed instructions

Here's a step-by-step guide with details on how to do everything you need to know to add GitHub authentication to your MDN account.

Sign in to your MDN account

  1. At the top of any MDN page, mouse-over or tap the Sign in box, located in the top-right corner of your MDN window:
    Sign in box on MDN, showing Persona and Github.
  2. This will either immediately log you in if you're already logged in to GitHub and have connected your GitHub login to your MDN account, present you with the GitHub authentication dialog if you've connected your GitHub account to MDN but aren't presently logged in to GitHub, or take you to GitHub's "Authorize application" page to associate your GitHub login with your MDN account.

Setting up GitHub authentication

If you're not already logged in to GitHub, you'll be asked to do so at this point, with a "Sign in to GitHub" dialog appearing on the screen:

  1. If you're not already signed in to GitHub, you'll be asked to do so:
    Screenshot of GitHub sign in window.
  2. If you have two-factor authentication enabled on your GitHub account, you'll be asked to enter your authentication code:
    Screenshot of GitHub's Two-factor authentication window.
  3. Now that you're signed in to your GitHub account, you'll be asked to authorize the link between GitHub and MDN (unless you already have this authorization on file for some reason). This page is shown below.
    Screenshot of GitHub "Authorize application" window.
    Click the green Authorize application button to grant permission for your MDN profile to access your GitHub account. If the GitHub account is successfully linked to your MDN profile, you'll see this message:
    Account successfully created.
  4. You will now be taken to MDN's "Create your MDN profile to continue page". Since you're updating an existing MDN profile, you should see at the top a yellow box that shows matching MDN accounts that use email addresses affiliated with your GitHub account, like this:
  5. Click the "Recover my profile" next to the email address corresponding to the MDN account you wish to attach your GitHub login to. A recovery verification email will be sent to you. Click the link in that email and you'll be taken to a "Connect Account" page on MDN, which looks like this:
  6. Click the "Connect with GitHub" button to complete the connection process; you'll be taken to your MDN profile page so you can confirm the information contained there. But your account is now all set and ready to use.
  7. If you don't already have an MDN account, fill out the information at the bottom of the page to create one, which will be associated with your logged-in GitHub account automatically, and respond to the authentication email we send to you.  Clicking the link in that email will take you to the Connect Account page as seen above; clicking the "Connect with GitHub" button will complete the process and take you to your account profile page.

Not only can you now use GitHub to sign in to MDN, but you're actually already signed in using your GitHub authentication! Be sure to update any password managers you may have installed, if necessary.


If you run into problems while trying to add your GitHub account to your profile, hopefully the troubleshooting tips below will help. If they don't, please don't hesitate to ask us for help on the #mdn IRC channel. You can also file an "Account Help" bug on Bugzilla. Be sure to provide your MDN username, your GitHub-registered email address, and any details you feel need to be included.

See also