BT Login Logo Documentation

Replace the default WordPress login page logo with your own brand image in seconds. No code required.

Overview

BT Login Logo is a free WordPress plugin that lets you fully customize your login page. Replace the WordPress logo, add a background image or color, style the login form, customize the button, and add custom CSS — all without writing a single line of code.

The plugin works with any WordPress theme and adds a single settings page under Settings › Login Logo organized into sections: Logo, Background, Login Form, Button & Links, and Custom CSS.

Installation

Download the .zip file from the Boulley Technology website. In your WordPress admin, go to Plugins › Add New › Upload Plugin, select the ZIP file, and click Install Now.

Once installed, click Activate. The settings page is available immediately at Settings › Login Logo.

BT Login Logo requires WordPress 5.0 or higher and PHP 7.4+.

Logo Settings

The logo section controls the image that replaces the default WordPress logo on the login page.

Logo Image URL — Paste any image URL or click Choose Image to pick from your WordPress Media Library.
Logo Width (px) — Display width in pixels. Default is 320px to match the login form width.
Logo Height (px) — Display height in pixels. Match your image's aspect ratio to avoid stretching.
Logo Link URL — Where the logo links when clicked. Defaults to your homepage.

Tip: Use a logo that is at least twice the display width (e.g., 640px wide for 320px display) so it looks sharp on retina screens.

Background

Customize the full-page background of your login page.

Background Color — Pick any color using the color picker. Default is WordPress gray (#f0f0f1).
Background Image — Upload your own image via the Media Library, paste a URL, or select from one of the 10 preset backgrounds.
Background Size — Choose how the background image fills the screen:
- Cover — Fills the entire screen (default, recommended)
- Contain — Fits the full image inside the screen
- Original Size — Displays at the image's native resolution
- Tile / Repeat — Repeats the image as a pattern

Preset Backgrounds

BT Login Logo includes 10 high-quality preset background images you can apply with one click. Simply click any thumbnail in the settings page to select it. The presets include:

Mountain Lake — Scenic mountain landscape
Ocean Waves — Blue ocean water
Dark Gradient — Purple-pink gradient
City Skyline — Urban cityscape
Forest Path — Green forest trail
Abstract Blue — Blue abstract gradient
Night Stars — Mountain night sky
Minimal Desk — Clean workspace
Autumn Leaves — Fall foliage
Sunset Sky — Golden hour sky

You can also upload your own background image using the Choose Image button or paste any URL. Click Clear to remove the background image and use only the background color.

Customize the appearance of the login form box itself.

Form Background — Color of the login form box. Default is white (#ffffff).
Form Border Radius (px) — Round the corners of the form. Set to 0 for sharp corners, up to 30px for fully rounded.
Form Shadow — Add depth to the form with a shadow effect:
- None — No shadow (default)
- Light — Subtle shadow
- Medium — Moderate shadow
- Heavy — Prominent shadow

Tip: When using a dark background image, try setting the form background to a semi-transparent white and adding a medium or heavy shadow for a modern floating card effect.

Button & Links

Customize the login button and text links on the login page.

Button Background Color — The color of the "Log In" button. Default is WordPress blue (#2271b1).
Button Text Color — Text color inside the button. Default is white.
Button Border Radius (px) — Round the button corners. Default is 3px. Set higher for pill-shaped buttons.
Link Color — Color of the "Lost your password?" and "Back to site" links below the form.

Custom CSS

For advanced customization beyond what the settings provide, you can add your own CSS in the Custom CSS textarea. This CSS is loaded only on the login page and does not affect your frontend or admin dashboard.

/* Example: Make the login form wider */ #loginform { max-width: 400px; padding: 30px; } /* Example: Change the page font */ body.login { font-family: 'Poppins', sans-serif; }

Troubleshooting

Logo Not Showing

Verify the Logo URL is correct and publicly accessible. Open the URL directly in your browser to confirm the image loads. If you use a CDN or security plugin that restricts hotlinking, make sure the image URL is whitelisted.

Background Image Not Appearing

Check that the image URL is correct. If using a preset, make sure your server can reach external URLs (some hosting providers block outbound requests). Try uploading the image to your own Media Library instead.

Styles Not Applying

If your changes don't appear on the login page, clear your browser cache and any caching plugins. Some security or optimization plugins may cache the login page aggressively.

FAQ

Does this plugin affect the rest of my site?

No. BT Login Logo only modifies the WordPress login page (wp-login.php). It does not load any CSS or JavaScript on your frontend or admin dashboard.

Can I use an SVG logo?

Yes, as long as your WordPress installation allows SVG uploads. By default WordPress blocks SVGs for security reasons, but if you have an SVG support plugin installed, you can use an SVG URL in the Logo URL field.

Will it work with custom login page plugins?

BT Login Logo hooks into the standard login_enqueue_scripts action. It works with the default WordPress login page and most plugins that extend it. However, plugins that completely replace the login page with a custom template may override the styles.

Are the preset background images free to use?

Yes. All preset backgrounds are sourced from Unsplash and are free for commercial and personal use with no attribution required.

Can I customize the login page differently for different users?

No. The login page customization applies to all users who visit your login page. The settings are global, not per-user.

Support

If you run into anything that isn't covered here:

Submit a support ticket at boulleytechnology.ca/support.php
Email support at support@boulleytechnology.ca
General inquiries: info@boulleytechnology.ca

License holders get priority response. We typically reply within a few hours during business hours.