How To Show Login Page In Customizer Preview

How To Articles

As a web developer, I often find the need to customize the appearance of my login page. This allows me to create a unique and personalized experience for my users. One challenge I encountered was how to properly show the login page in the customizer preview. In this article, I will share with you the steps I took to achieve this, along with some personal insights and tips.

Understanding the Customizer

The WordPress Customizer is a powerful tool that allows you to customize various aspects of your WordPress theme in real-time. It provides a live preview of the changes you make, making it easier to tweak and fine-tune your design. However, the default behavior of the Customizer does not include the login page, which can make it difficult to see how your customizations affect this important aspect of your website.

Step 1: Registering the Login Page

To start, we need to register our login page with the Customizer. We can do this by adding a custom section and setting it to only show up when the user is in the Customizer preview.

// Add custom section for the login page
function my_customizer_login_page_section( $wp_customize ) {
    $wp_customize->add_section( 'login_page', array(
        'title'     => __( 'Login Page', 'my-theme' ),
        'priority'  => 160,
    ) );
add_action( 'customize_register', 'my_customizer_login_page_section' );

By registering the login page as a custom section, we can now add custom settings and controls specifically for this page.

Step 2: Adding Login Page Settings

Now that our custom section is registered, we can add the necessary settings and controls to customize the login page. Here’s an example of how we can add a setting to change the background color of the login page:

// Add background color setting for the login page
function my_customizer_login_page_settings( $wp_customize ) {
    $wp_customize->add_setting( 'login_page_background_color', array(
        'default'           => '#ffffff',
        'sanitize_callback' => 'sanitize_hex_color',
    ) );
    $wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'login_page_background_color', array(
        'label'    => __( 'Background Color', 'my-theme' ),
        'section'  => 'login_page',
        'settings' => 'login_page_background_color',
    ) ) );
add_action( 'customize_register', 'my_customizer_login_page_settings' );

Feel free to add more settings and controls based on your requirements. This allows you to customize various aspects of the login page, such as the logo, login form, and more.

Step 3: Showing the Login Page in the Customizer Preview

By default, the login page is not shown in the Customizer preview. However, we can modify the Customizer to include the login page by using a simple JavaScript snippet.

(function( $ ) {
    wp.customize.bind( 'ready', function() {
        wp.customize.previewer.bind( 'before-toggles', function() {
            $( 'body' ).addClass( 'showing-login-page' );
        } );
        wp.customize.previewer.bind( 'after-toggles', function() {
            $( 'body' ).removeClass( 'showing-login-page' );
        } );
    } );
})( jQuery );

This JavaScript snippet adds a class to the <body> element called showing-login-page when the login page section is opened in the Customizer. This allows us to target specific CSS styles for the login page only when it is being previewed in the Customizer.

Personal Insights and Tips

During my journey of showing the login page in the Customizer preview, I encountered a few challenges and discovered some useful tips. Here are some of my personal insights:

  • Testing: Always test your customizations in different browsers and devices to ensure a consistent experience for your users.
  • Security: Be cautious when customizing the login page, as it plays a crucial role in user authentication. Avoid adding unnecessary elements or modifying core functionality.
  • User Experience: Consider the usability and accessibility implications of your login page customizations. Ensure that your design choices do not hinder the login process for your users.

Remember, the login page is the gateway to your website. By customizing its appearance in the Customizer, you can create a cohesive and personalized experience for your users.


In this article, we explored how to show the login page in the Customizer preview. By registering a custom section, adding settings and controls, and using a JavaScript snippet, we can fully customize the login page within the Customizer. Remember to test your customizations thoroughly and consider the security and user experience implications. Happy customizing!