1. cPanel & WHM Documentation
  2. WHM
  3. Themes
  4. Theme Manager
branding themes whmui

Theme Manager

Valid for versions 108 through the latest version

Version:

108

Last modified: February 22, 2024

Overview

The Theme Manager interface allows you to to install, preview, clone, download, and delete custom themes for the cPanel, Login, and Webmail interfaces. The theme contains many elements, such as HTML and CSS.

Note:
  • We do not support custom themes or localization for WHM.
  • This interface does not support customization of a theme. Use WHM’s Customization interface (WHM » Home » cPanel » Customization) to apply changes to this interface.

File dependencies

When you create your own themes or use a theme that WebPros International, LLC does not provide, you must ensure that the following files exist:

  • /usr/local/cpanel/base/frontend/$theme/passwd/changepass.html

  • /usr/local/cpanel/base/frontend/$theme/passwd/index.html

These files control interfaces that the system uses whenever you change a cPanel user’s password. If you do not copy or create these interfaces, users cannot change their passwords if the following conditions are true:

  • You used WHM’s Force Password Change interface (WHM » Home » Account Functions » Force Password Change) to require the user to change the account’s password.

  • The user’s password is too old or too weak, as you defined in WHM’s Configure Security Policies interface (WHM » Home » Security Center » Configure Security Policies).

Theme Manager

The Theme Manager interface allows you to install, preview, clone, download, and delete custom themes for the following interfaces:

  • Default cPanel Themes — When you click Customize Themes under Default cPanel Themes, the system directs you to WHM’s Customization interface (WHM » Home » cPanel » Customization).

  • cPanel — A theme for the cPanel interface. Click Manage Themes to install, preview, clone, download, and delete custom themes.

  • Login — The theme that appears on the cPanel login interface. Click Manage Themes to install, preview, clone, download, and delete custom themes.

  • Webmail — The theme that appears on the cPanel webmail interface. Click Manage Themes to install, preview, clone, download, and delete custom themes.

Manage Themes

After you select a theme to manage, you can install, preview, clone, download, and delete a theme.

Note:

For the cPanel and Webmail options, you must upload and install a custom theme before you can preview, clone, download, or delete one.

Preview a theme

To preview a theme, click the view icon (View) that corresponds to the theme that you wish to view.

Clone a theme

When you clone a theme, the system creates a copy of the theme. To clone a theme, perform the following steps:

  1. Click the clone icon (Clone) that corresponds to the theme that you wish to edit. A new interface will appear.

  2. Enter a name for the cloned theme in the text box.

  3. Click Submit. The system will clone the theme and display it in the Themes table.

Download a theme

To download a theme, click the Download icon (Download). Your browser will download the file.

Delete a theme

To delete a theme, perform the following steps:

  1. Click the Delete icon (Delete). The system will direct you to a confirmation interface.

  2. Click Yes to confirm that you wish to delete the theme or click No to cancel.

Upload and install a theme

To upload or install new themes, perform the following steps:

  1. Click Manage Themes for the desired interface.

  2. Under the Install Theme heading, click Choose File. Select the new theme’s file.

  3. Click Upload. The new theme will appear in the Themes table.

Additional Documentation