We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.

We will continue to maintain our API documentation on this server.

Skip to end of metadata
Go to start of metadata


cPanel & WHM's login theme determines the appearance of login pages. Login themes include template files, image files and logos, CSS files, and a favicon for the login pages. 

  • Your customers view these pages each time that they log in to their accounts.
  • The default login theme exists in the /usr/local/cpanel/base/unprotected/cpanel/ directory.


  • You can view your server's available login themes in WHM's  Theme Manager interface (WHM >> Home >> Themes >> Theme Manager).
  • In cPanel & WHM version 54 and later, if your custom interfaces require jQuery, you must include that code in require() blocks. For more information, read our Guide to cPanel Interface Customization - jQuery documentation. 

Login theme development workflow

When you customize a login theme, we recommend that you use the following workflow:

  1. Use WHM's  Theme Manager interface ( WHM >> Home >> Themes >> Theme Manager )  to clone the existing login theme.
  2. Update logos and other login theme image assets.
  3. Update the desired login page templates.
  4. Update the style_v2.css and style_v2_optimized.css files with any desired CSS changes.
  5. If necessary, update your server's locales with any new phrases that you added to the login pages.
  6. Select the new login theme from the Default login theme menu in WHM's  Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).