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 lightweight WordPress plugin that replaces the default WordPress logo on the wp-login.php page with your own custom image. It also lets you change where the logo links to and control the logo dimensions, so your login page matches your brand instead of showing the generic WordPress logo.

The plugin is free, has no dependencies, and works with any WordPress theme. It adds a single settings page under Settings › BT Login Logo with everything you need.

Installation

Download the .zip file from the Boulley Technology catalog or install it directly from the WordPress plugin directory. 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 › BT Login Logo.

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

Settings

All configuration is done from Settings › BT Login Logo. The following options are available:

Logo URL — The full URL to your logo image. You can paste any image URL or use the Select Image button to pick an image from your WordPress Media Library.
Logo Width — The display width of the logo in pixels. The default is 320px, which matches the width of the login form.
Logo Height — The display height of the logo in pixels. Set this to match your image aspect ratio so it does not appear stretched or squished.
Logo Link URL — Where the logo links to when clicked. By default, the WordPress login logo links to wordpress.org. Change this to your site's homepage or any other URL.

Tip: For best results, use a logo image that is at least twice the display width (e.g., 640px wide for a 320px display) so it looks sharp on retina displays.

Troubleshooting

Logo Not Showing

If your custom logo does not appear on the login page, verify the Logo URL is correct and publicly accessible. Open the URL directly in your browser to confirm the image loads. If you are using a CDN or security plugin that restricts hotlinking, make sure the image URL is whitelisted.

Logo Looks Stretched or Squished

Make sure the width and height values match the actual aspect ratio of your image. For example, if your logo is 600x200 pixels, set the width to 300 and the height to 100 (or any proportional values). Mismatched dimensions will distort the image.

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 logo styles.