Authentication Pages

Authentication Pages Customizer Guide

This guide explains the Authentication Pages option in the WordPress Customizer.

Use this Customizer area to edit the content, fields, notifications, design, and login redirect behavior for the site’s login, registration, lost password, and reset password pages.

Open the Authentication Pages Customizer Panel

In the WordPress dashboard, go to Appearance > Customize.
Open Authentication Pages.
Choose the section you want to edit.
Make your changes.
Click Publish.

Login Page Content

Use Login Page Content to customize the text shown on the login page.

You can edit:

Login headline
Login description
Three feature text items
Three feature icons

The login page supports the {site_name} placeholder in supported text fields where noted in the Customizer description.

Login Page Design

Use Login Page Design to style the login page.

You can customize colors for:

Page background
Form background
Welcome section gradient
Welcome text
Form title
Labels
Input fields
Button gradient
Button text
Links
Error messages
Success messages
Secondary text
Required asterisk color

You can also control whether the login form shows:

Remember Me checkbox
Forgot Password link
Create Account link

Register Page Content

Use Register Page Content to customize the regular registration page.

You can edit:

Register headline
Register description
Four benefit text items
Four benefit icons

Register Page Design

Use Register Page Design to style the registration page.

You can customize colors for:

Page background
Form background
Welcome section gradient
Welcome text
Form title
Labels
Input fields
Button gradient
Button text
Links
Error messages
Success messages
Secondary text
Required asterisk color

Registration Form Fields

Use Registration Form Fields to add up to two extra fields to the registration form.

For each custom field, you can set:

Enable Custom Field
Custom Field Label
Custom Field Slug

The label is what visitors see on the registration form. The slug is the unique key used to save that field, so keep it simple and avoid spaces.

Registration Notifications

Use Registration Notifications to receive an email when a new user registers.

You can set:

Send registration notifications
Notification Email

Enter the email address where registration notifications should be sent.

Lost Password Page Content

Use Lost Password Page Content to customize the page users see when requesting a password reset link.

You can edit:

Lost Password headline
Lost Password description
Three feature text items
Three feature icons

Lost Password Page Design

Use Lost Password Page Design to style the lost password page.

You can customize colors for:

Page background
Form background
Welcome section gradient
Welcome text
Form title
Labels
Input fields
Button gradient
Button text
Links
Error messages
Success messages
Secondary text
Required asterisk color

Reset Password Page Content

Use Reset Password Page Content to customize the page users see after opening a password reset link.

You can edit:

Reset Password headline
Reset Password description
Three feature text items
Three feature icons

Reset Password Page Design

Use Reset Password Page Design to style the reset password page.

You can customize colors for:

Page background
Form background
Welcome section gradient
Welcome text
Form title
Labels
Input fields
Button gradient
Button text
Links
Error messages
Success messages
Secondary text
Required asterisk color

Business Registration Landing

Use Business Registration Landing to customize the business registration choice page.

You can edit:

Registration paths to display
Landing headline
Landing description
Professional card title
Professional card description
Professional feature text
Professional button text
Client card title
Client card description
Client feature text
Client button text
Footer alternative text
Footer alternative link text

This section is for sites using the business registration flow.

Professional Registration Form

Use Professional Registration Form to customize the professional registration page.

You can edit:

Form headline
Form description
Benefits heading
Benefit text
Submit button text

Client Registration Form

Use Client Registration Form to customize the client registration page.

You can edit:

Form headline
Form description
Benefits heading
Benefit text
Submit button text

Authentication Pages – Design

Use Authentication Pages – Design to control shared styling for authentication pages.

This section includes shared color controls for login, register, lost password, and reset password pages, including:

Page background color
Form background color
Welcome section gradient
Welcome text color
Form title color
Label color
Input border color
Input focus border color
Button gradient
Button text color
Link color
Error message colors
Success message colors

This section also includes Login Redirect Destination.

Login Redirect Destination

Use Login Redirect Destination to choose where users go after logging in.

Available options are:

Dashboard
Activity Feed
User Profile
Homepage
Return to Previous Page
Custom URL

If you choose Custom URL, enter the full destination URL in Custom Redirect URL.

When a visitor logs in after trying to view a protected page, the protected page redirect is respected.

Test the Authentication Pages

After publishing your changes:

Open the login page while logged out.
Confirm the headline, description, feature text, icons, form links, and styling are correct.
Open the registration page and confirm the registration content and fields are correct.
Test the lost password page by requesting a password reset email.
Open the reset password link from the email and confirm the reset password page appears correctly.
Log in with a test user and confirm the redirect destination works as expected.

Troubleshooting

I do not see my changes on the page

Click Publish in the Customizer, then clear any site or browser cache and test again while logged out.

The login page redirects me away

The login template redirects already logged-in users. Test the login page in a private browser window or after logging out.

The custom redirect is not being used

Confirm Login Redirect Destination is set to Custom URL, then confirm the full URL is entered in Custom Redirect URL.

If a user was sent to login from a protected page, that protected page can take priority after login.

The password reset link does not show the branded reset page

Confirm the site has a reset password page using the theme’s Reset Password page template, then send a new reset password email and test the new link.