README

Contributors: austyfrosty , frostymedia
Donate link: PayPal
Tags: admin, branding, customization, custom login, logo
Requires at least: 6.7
Tested up to: 6.8.3
Requires PHP: 8.3
Stable tag: 5.1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Custom Login allows you to easily customize your admin login page, works great for client sites!

Description

Custom Login 2.0 was 140% faster than version 1.0, and version 4.0 is now even better!

NOTE: For version 5, this plugin should be installed via composer or from WordPress only. If you are not running PHP 8.3, grab the php74 release asset.

For more information, visit the official Custom Login page.

Support
Austin and the Frosty Media team will always try our best to support the Custom Login plugin on the WordPress.org forum, but please note that we cannot guarantee a response in a timely manner. If you have an issue we would appreciate you using GitHub or purchasing priority support on our site.

Any extensions purchased on Frosty Media (not hosted on WordPress.org) will not be supported on the WordPress.org forum. You can always browse our small but growing documentation for further assistance. You need a valid license key to make support submissions on our site. We thank you in advance.

Bug Reports
Bug reports for Custom Login are welcomed on GitHub.

Video

Extensions

There are currently 7 premium extensions available, with more coming (suggestions welcome - and will be offered for free to said user).

Extensions available now

Stealth Login
- obscure your login URL.
Page Template
- add a login form to any WordPress page.
Login Redirects
- Manage login redirects.
No Password
- allow users to login without a password.
Style Pack #1 ⭐️
- four pre-designed login styles.
Style Pack #2 ⭐️
- four pre-designed fun login styles.
Style Pack #3 ⭐️
- four pre-designed holiday login styles.

Extensions in development/extension ideas

Email Logins for usernames.
2-step Authentication.
"Super User" only access for client sites.
Added in core as of version 3.0 Remove default WordPress login CSS.
Submit button styles!
Added as of version 3.2 Custom Login pre-made settings templates * AKA* Style Packs.

More info

Activate the plugin and customize your WordPress login screen. It's as easy as modifying a few settings, there is no need to understand CSS at all. Custom Login even has a HTML, CSS & jQuery textarea for more advanced customizations.

Read more about Custom Login 5.0
Read more about Custom Login 4.2 & 4.3
Read more about Custom Login 4.0
Read more about Custom Login 3.1

For those looking to show off your login screen, check out the Flickr group! Share you designs with the community!

Installation

Installation via composer:

composer require thefrosty/custom-login:^5

Or, follow the steps below to install the plugin.

Upload the custom-login directory to the /wp-content/plugins/ directory.
Activate the plugin through the 'plugins' menu in WordPress.
Go to Settings/custom-login to edit your settings.
Design away.
Activate the settings by checking "Enable" in the "General Settings" tab.

Frequently Asked Questions

What are extensions?

They are additional plugins that add/extend functionality to the Custom Login plugin. You can find all Custom Login extensions on Frosty.Media.

Is there a PRO version?

Not anymore.

Where can I upload and share my cool login screen?

Check out the Flickr group! Upload and add it to our pool!

I think I want to uninstall

Just deactivate it. Sad panda is sad.

Where do I report security bugs found in this plugin?

Please report security bugs found in the source code of the Custom Login plugin through the Patchstack Vulnerability Disclosure Program. The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.

Screenshots

Custom Login showcase on the Flickr group.

1. Custom Login v3 Design Settings part 1.

2. Custom Login v3 Design Settings part 2.

3. Custom Login v3 General Settings.

4. Custom Login Extensions Installer (an active license key is required).

Changelog

Version 5.1.2.2 (2025/11/29) =

Upstream dependency updates from thefrosty/wp-utilities.
Don't load vendor/autoload.php if already autoloaded externally.

Version 5.1.2.1 (2025/11/23) =

Fix edge case Fatal error found in legacy plugins using Hash from thefrosty/wp-utilities update.

Version 5.1.2 (2025/11/22) =

Bump thefrosty/wp-utilities.

Version 5.1.1 (2025/11/14) =

Resolve gettext mixed type fatal error.

Version 5.1.0 (2025/11/14) =

Bump js-yaml and standard by @dependabot[bot]
Feature: Add Login style with srcset for responsive image backgrounds.

Version 5.0.2 (2025/10/11) =

Remove roave/security-advisories (due to political support on their README I don't agree with).

Version 5.0.1 (2025/07/16)

Fix: export-ignore for Composer installs.
Bump PHPUnit to 11.
Change Requires PHP back to 8.3 (modified in downgrade action)

Version 5.0.0 (2025/07/15)

Tested up to 6.8.2
Bumped dependencies for PHP >= 8.3.
Dropped plugin PHP support back to >= 7.4 (WordPress install) with Rector.
Add better Composer installation support, requires PHP >= 8.3.

Version 4.5.2 (2025/06/10)

Bump WP Utilities to 3.4.3
Resolve dashboard visibility no hiding on setting toggle.
Update default remote request timeout from 15 to 2 seconds.

Version 4.5.1 (2025/05/20)

Only load Import/Export on Custom Login Settings page.

Version 4.5.0 (2025/05/14)

Add roave/security-advisories
Update codecov-action to v5
Setting: Expose Extensions Submenu
🔄 Regenerate translation files
Readme Updates
Update references from Twitter to X.
Hide "active" Custom Login Extensions from the plugins.php page
Bug: Fix Codemirror syntax issue

Version 4.4.0 (2025/04/14)

Requires PHP >= 8.1.
Bump Tested up to too "6.8.0".
Resolve "Translation loading for the custom-login domain was triggered too early" added in WP 6.7.0.

Version 4.3.0 (2024/10/30)

Bump Tested up to too "6.7.0"
Updated login logo HTML attribute for CSS targeting in WP 6.7.

Version 4.2.0 (2024/04/25)

Bump Tested up to too "6.5.2"
Resolve possible "Uncaught TypeError" when initializing wp.codeEditor on empty element.
Development enhancements.

Version 4.1.1 (2023/12/13)

Resolve Security Vulnerability (CVE-2023-49858).

Version 4.1.0 (2023/11/09)

Drop support for PHP <= 7.4.
Resolve PHP deprecation notices in PHP 8.2.
Official supported WordPress is >= 6.2.
Tested with WordPress 6.4.
Remove deprecated function CUSTOMLOGIN().
Fix: resolve use of path instead of URL for animate.css.

Version 4.0.12 (2023/12/13)

Resolve Security Vulnerability (CVE-2023-49858).

Version 4.0.11 (2023/09/20)

Fix: Removed Opis Closure package (causing PHP deprecation notices in 8.1+).

Version 4.0.10 (2023/04/08)

Fix: Uninitialized value.

Version 4.0.9 (2023/03/31)

Fix: Resolve edge case error on setting page.

Version 4.0.8 (2022/08/11)

Fix: Make sure WordPress' capabilities array keys are string values to avoid shutdown action fatal errors.

Version 4.0.7 (2022/08/09)

Don't type cast the return value of removeLostPasswordText. #75
Uncomment update option to resolve upgrade notice always showing. #76
Don't show the tracking notice, when opt-in or opt-out has already been selected. #77
Update WpSettingsApi, and use new condition checks for sidebar(s). #78
Update missing autoload notice message. #80

Version 4.0.6 (2022/08/08)

Fix: Resolve micro regression with psr/container issues.
Fix: Resolve file (URL) fields breaking on save.
Update WP Utilities to 2.8.
Update WP Settings API to 3.6.

Version 4.0.5 (2022/08/06)

Make sure autoloading is working before loading classes on plugin uninstall.
Full Changelog: 4.0.4...4.0.5

Version 4.0.4 (2022/08/05)

Change PSR Container package to use version 1 instead of 2 to avoid WooCommerce errors; fixes #65
Full Changelog: 4.0.3...4.0.4

Version 4.0.3 (2022/08/04)

Update both README's with correct "requires at least", "tested up to", and "requires PHP" header tags.
Cleanup admin notice messages when "unable to activate" due to invalid PHP version or missing autoload.
Full Changelog: 4.0.2...4.0.3

Version 4.0.2 (2022/07/15)

Don't show error message when not in admin.

Version 4.0.1 (2022/05/23)

Version bump, including manually adding missing vendor directory (need to fix GitHub action).

Version 4.0.0 (2022/05/23)

Complete rewrite.
Required PHP >= 7.4.
Full Changelog: 3.2.15...4.0.0

Version 3.2.15 (2022/03/11)

Fix settings API Settings: Uncaught Error: Call to undefined method stdClass::get_permalink() (#49)

Upgrade Notice

4.4.0

Requires WordPress version >= 6.6 and PHP version >= 8.1.

4.1.0

Requires WordPress version >= 6.2 and PHP version >= 8.0.

4.0.1

Requires WordPress version >= 5.7 and PHP version >= 7.4.

thefrosty / custom-login

Maintainers

Details