Installation of the Login by Auth0 WordPress Plugin

In order to install or customize plugins, you must use a self-hosted WordPress.org site. Using a WordPress.com site does not allow installing plugins. More information on the differences here.

Plugins can be added to your WordPress site automatically or manually. Both processes are covered here in the WordPress Codex.

As soon as the plugin is activated, you are redirected to the start of the Setup Wizard.

WordPress-Auth0 Plugin Banner

If you don't already have an Auth0 account, click the Sign Up For Free. button and create one before proceeding.

Manual setup

The plugin can be configured using the built-in setup wizard (covered below) or manually by creating an Application and assigning connections. The completely manual setup process can be used if you're having trouble with the wizard, have been through the setup process before, or want to share a database connection between Applications.

  1. In your Auth0 Dashboard, click Applications then Create Application
  2. Give your Application a descriptive name, select Regular Web Applications, then Create
  3. Follow the Application setup instructions closely through the "Update Auth0 settings in WordPress" section to configure the application for your WordPress installation

Once the steps above are complete, your site will be configured and ready to use!

Wizard - Social Login

Click Social to start the basic Auth0 setup.

Automatic

Public servers that allow incoming connections from Auth0 will begin the Automatic setup process. Authorize the WordPress site for your tenant and everything will be setup automatically, including user migration.

WordPress-Auth0 Plugin Banner

Manual

This process is used for servers without incoming connections from Auth0, such as a local development machine or a server with access blocked by a firewall or other protection.

WordPress-Auth0 Plugin Banner

In the modal that appears, enter the domain name for your tenant and a valid, manually-generated Access Token. Follow the instructions here - "Get a token manually" section - to create the token and find your domain.

If the first part of the setup successfully completes, you'll see the "Configure your social connections" screen. If not, to go Auth0 > Settings > Basic, delete your Client ID and domain, then click Setup Wizard in the admin menu to start again. Check the Auth0 Error Log in wp-admin for more information about what went wrong and post in our Community if you need support.

Click Next to continue the setup process by migrating your administrator account.

WordPress-Auth0 Plugin Banner

This step connects your WordPress user with an Auth0 user that authorizes you to log in. You can choose the same password as your admin account or different but make sure it conforms to the "Fair" password policy described here (the default for this plugin).

Setup complete

When you see the "Done" screen, Auth0 is setup and ready to accept logins and, if configured, signups!

WordPress-Auth0 Plugin Banner

This is a good time to confirm that the basics are working for your site before changing any of the default settings:

  1. Log out of WordPress and confirm that the Auth0 form now appears at /wp-login.php.
  2. Log in with the Auth0 user created above.
  3. Log out and try creating an account with a different email address (if you have "Anyone can register" turned on in your General WordPress settings).
  4. Try logging in using a social connection (if you've turned those on).

Now you're ready to Configure!

Keep Reading

More information on the Login by Auth0 WordPress plugin: