Skip to content

BuddyX Pro ships four ready-made styles for the WordPress login, register, and lost-password pages. You pick a preset card, set a brand color, and (for the split and hero layouts) add a background image - the theme renders a complete, polished login look with no per-control tuning. This replaces the older 81-field login customizer with a six-control surface that mirrors the Style and Font preset pickers used elsewhere in BuddyX Pro.

Each preset is opinionated and complete. Once you choose one, BuddyX Pro handles the card radius, shadows, spacing, and heading colors for you. You only supply the brand inputs:

  • Your brand color (button, links, focus rings, and the brand panel in split layouts).
  • A background image (used by three of the four presets).
  • An optional login logo (falls back to your Site Identity logo if left blank).
  • An optional Form opacity value, if the preset’s own card transparency is not what you want.

The same preset applies across all three account surfaces - the login page, the lost-password page, and the register page (including the BuddyPress register screen and any page you map as your registration page).

  1. Go to Appearance > Customize.
  2. Open the WP Login panel, then the Logo section.
  3. Turn Custom login branding on. (It is off by default, so a fresh install keeps the standard WordPress login until you opt in.)
  4. Under Layout, click the card for the preset you want.
  5. Set your Brand color.
  6. For Brand left, Brand right, or Hero image, upload a Background image.
  7. Optionally drag Form opacity to change how solid the form card looks.
  8. Optionally set a Login logo override.
  9. Click Publish.

The Layout, Brand color, Background image, Form opacity, and Login logo override controls stay hidden until Custom login branding is on. The Background image control also hides itself for the Minimal preset, which does not use one.

Preset What it looks like Uses background image
Minimal Centered form card on a calm, plain background. No
Brand left Background image fills the left panel; the form sits on the right. Yes
Brand right Background image fills the right panel; the form sits on the left. Yes
Hero image Fullscreen background image; the form floats centered over a translucent backdrop. Yes

Minimal is the default. Choose it when you want a clean, distraction-free sign-in and do not have a brand image to feature. Brand left and Brand right are the split-screen layouts - use them when you have a strong vertical or half-frame image (a community photo, a product shot) and want it beside the form. Hero image is the most immersive option - a single full-bleed image with the form floating on top - and suits landing-style community and membership sites.

After you pick a preset, the remaining controls in the Logo section shape it to your brand.

Control Key Default Notes
Brand color custom_login_brand_color #0f172a The single accent source. It colors the sign-in button, form links, focus outlines, and - on Brand left and Brand right - the brand panel background behind your image. Alpha is disabled, so pick a solid color.
Control Key Default Notes
Background image custom_login_background_image Empty Used by Brand left, Brand right, and Hero image. Minimal ignores it, so the control hides when Minimal is selected. Use a large, high-quality image - hero layouts show it fullscreen, split layouts show it at roughly half width.
Control Key Default Notes
Form opacity custom_login_form_opacity 100 A 0 to 100 slider (step 1) that sets the background transparency of the sign-in card. At 100 the card is solid. At 0 the fields sit directly on the background with no card behind them.

Default: 100 in the slider, but that is only what the slider shows until you save it. Until you move and publish the slider, each preset keeps the card it was designed with: Hero image renders its card at 96%, and Minimal, Brand left, and Brand right render theirs at 100%. So on a fresh Hero image login, dragging the slider to 100 is a real change, not a no-op.

A few things worth knowing:

  • The card’s border and shadow fade with it. At low values you do not get an outline floating over the background, and at 0 the card leaves nothing behind.
  • The value applies everywhere the branding does - /wp-login.php, the lost-password screen, and the register page.
  • On an upgrade from BuddyX Pro 5.0.x, see Upgrading from an earlier version below. The slider can already read 0 on your site without you touching it.
Control Key Default Notes
Login logo override custom_login_logo_image Empty Optional. Leave it blank to reuse the logo from Appearance > Customize > Site Identity. Set a different image here when the login page needs its own mark - for example a square icon that reads better than your wide header logo.

Logo source order: BuddyX Pro uses the Login logo override first, then falls back to your Site Identity logo, and finally to the site title text if neither is set. Most sites that already configured a header logo need to do nothing here.

Six controls drive every login look. Here they are together, in the order they appear in the Logo section.

Control Key Type Default
Custom login branding enable_custom_login On / Off Off
Layout custom_login_preset Preset card picker Minimal
Brand color custom_login_brand_color Color #0f172a
Background image custom_login_background_image Image upload Empty
Form opacity custom_login_form_opacity Slider, 0 to 100 (%) 100
Login logo override custom_login_logo_image Image upload Empty

The section is named Logo, but it holds all six controls, so Form opacity is not where most people look for it first.

If you customized the login page on BuddyX Pro 5.0.x, your saved logo and background image carry over automatically. If you had set a login background image but never picked a 5.1.0 preset, BuddyX Pro starts you on the Hero image preset so that image stays visible on the first load after upgrade - rather than defaulting to Minimal and hiding it. You can switch to any other preset at any time.

Your old transparency choice carries over too. If you had the 5.0.x transparent login form switch turned on, BuddyX Pro sets Form opacity to 0 for you on upgrade, so the form stays as see-through as it was. That is why the slider can read 0 on an upgraded site nobody has touched. Drag it up if you want a solid card back. The carry-over runs once and never overwrites a value you have already saved.

The older per-field login settings (form radius, shadow opacity, input colors, and the rest) still exist in your database but are no longer read. Picking a preset is now the way to control all of that at once.

The preset list is filterable. Add or replace presets with the buddyxpro_login_presets filter, which passes the array of preset definitions (each with a label, description, and uses_bg flag). This lets a child theme register an additional layout without touching theme files.

Need a hand setting up your login presets? Email support@wbcomdesigns.com with a screenshot of your WP Login > Logo settings and the preset you picked.