Branding & Customization

The Whitelabel Login plugin lets you replace every visual element of the WordPress login experience with your own branding. No code required — everything is configurable from the settings page.

Navigate to Settings → Whitelabel Login → Login Page.

  • Upload custom logo: Click "Upload Logo" to use any image from your Media Library. Recommended size: 300×80px or similar horizontal format.
  • Use site logo: Check "Use Site Logo" to automatically pull the logo set in Appearance → Customize → Site Identity.
  • Logo link: By default, clicking the logo goes to your homepage. This replaces the default WordPress.org link.

Background

Three background options are available:

Solid Color

Select any color using the color picker. Works well with your brand's primary or secondary color.

Background Image

Upload a full-screen background image. The image is displayed using background-size: cover with a semi-transparent overlay on the form area for readability.

Background Video

Paste a video URL (MP4 hosted on your server or Media Library). The video plays muted and loops automatically. A fallback image is used on mobile devices where autoplay is restricted.

Form Styling

Customize the login form appearance with these options:

Option Description Default
Form background color Background of the login form card #ffffff
Form text color Color of labels and input text #333333
Button color Primary button background WordPress blue
Button text color Text color on the submit button #ffffff
Border radius Rounded corners on the form card and inputs 8px
Box shadow Toggle a subtle shadow around the form card On
Form width Maximum width of the login form 400px

Welcome Message

Add a custom tagline or welcome message that appears above the login form. Supports basic HTML for formatting. Leave blank to show no message.

Example:

<h2>Welcome to Our Community</h2>
<p>Sign in to access exclusive content and resources.</p>

Replace the default "Back to [Site Name]" link with custom footer text. Use this for copyright notices, links to terms of service, or contact information.

Supports HTML. Set to empty to remove the footer entirely.

Page Title & Favicon

  • Page title: Customize the browser tab title for the login page. Default: "Login — [Site Name]".
  • Favicon: Upload a custom favicon specifically for the login page, or leave blank to use your site's default favicon.

WordPress Branding Removal

The plugin automatically removes these WordPress-specific elements from the login page:

  • WordPress logo and link
  • "Powered by WordPress" text
  • Default "Back to [blog name]" link (replaced by your footer text)
  • Default login page styles
  • Language switcher (optional — can be re-enabled in settings)

Custom CSS

For advanced customization beyond the settings, use the Custom CSS field. This CSS is loaded only on the login page.

/* Example: change the form font */
.wl-login-wrap {
    font-family: 'Inter', sans-serif;
}

/* Example: style the tab navigation */
.wl-login-tabs a.active {
    border-bottom: 3px solid #6366f1;
    color: #6366f1;
}

/* Example: full-width inputs */
.wl-login-wrap input[type="text"],
.wl-login-wrap input[type="password"],
.wl-login-wrap input[type="email"] {
    width: 100%;
    padding: 12px 16px;
}

Custom JavaScript

Add custom JavaScript that runs on the login page. Useful for adding analytics tracking, chat widgets, or custom form validation.

// Example: track login page views
if (typeof gtag !== 'undefined') {
    gtag('event', 'page_view', {
        page_title: 'Login Page',
        page_location: window.location.href
    });
}

Live Preview

At the bottom of the Login Page settings tab, click "Preview Login Page" to open a live preview in a new tab. The preview reflects your current saved settings. Make changes, save, and refresh the preview to see updates.

Login Page Tabs

The login page includes three tabbed sections, all on a single page:

  1. Login — username/email + password fields, "Remember Me" checkbox
  2. Register — registration form (if registration is enabled)
  3. Lost Password — email field for password reset

Tab labels are translatable. You can customize them through the wl_login_tab_labels filter. See the Hooks & Filters reference.

Social Login Integration

The plugin provides a hook area for social login buttons. While social login providers are not bundled (to keep the plugin lightweight), you can add buttons via the wl_after_login_form action hook or use a compatible social login plugin that supports this hook area.

add_action( 'wl_after_login_form', function() {
    echo '<div class="wl-social-login">';
    echo '<p>Or sign in with:</p>';
    // Your social login buttons here
    echo '</div>';
} );