Theme Manager v82

Valid for versions 82 through the latest version




This set of features allows you to manage themes for the following interfaces: cPanel, Login, Webmail and WHM.

The system uses the cPanel & WHM theme as the skeletal frame on which to place the style, or skin. The theme contains many elements, such as HTML and CSS.


To manage a theme, click Manage Themes.

The Theme Manager interface allows you to manage the following themes:

  • Paper Lantern — The theme that appears in the cPanel interface for cPanel users who use the Paper Lantern theme.

    When you click Manage Theme for the Paper Lantern theme, the system redirects you to WHM's Customization interface (WHM >> Home >> cPanel >> Customization). For more information about cPanel interface customization, read our Guide to cPanel Interface Customization - cPanel Style Development documentation.

  • cPanel — The theme that appears in the cPanel interface for cPanel users who use other cPanel interface themes.
  • Login — The theme that appears on the cPanel login interface.
  • Webmail — The theme for webmail clients that ship with cPanel & WHM.
  • WHM — The theme that appears in the WHM interface. You, the web host, and your resellers will see this theme.

The Theme Manager

After you select a theme to manage, you can view, download, clone, upload, and delete the theme.

  • The instructions below apply to the cPanel, Login, Webmail, and WHM sections of the Theme Manager interface.
  • In order to create a custom webmail theme, you must use a cPanel theme of the same name.

View a snapshot of the theme

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

When you clone a theme, the system creates a copy of the theme.

Clone a theme

You can’t clone anything that doesn’t have a theme (for example, Webmail may not have a cloneable theme).
To clone a theme, perform the following steps:

  1. Click the clone icon that corresponds to the theme that you wish to edit.
  2. Enter the name for the newly-cloned theme on the next page.
    When you create a custom webmail theme, use the same name as your cPanel theme.
  3. Click Submit.

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

Download a theme

To download a theme, click Download (). You can delete themes so that old or unused themes do not take up disk space.

Delete a theme

To delete a theme, click Delete () and click Yes on the following interface to confirm that you wish to delete the theme.

Upload and install a theme

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

  1. Under the Install Theme heading, enter the name of the theme file, or click Browse.
  2. Select the theme file.
  3. Click Upload. The new theme will appear in the Themes table.

Try a theme (for WHM themes only)

To try a theme, click Activate () in the WHM Themes list. The interface instantly changes to the theme that you activated.

Addon Themes

Use the Theme Manager to install and update addon themes. Addon themes are additional themes that cPanel, L.L.C. or a third party provides.

To begin, click the Manage Addon Themes link at the bottom of the cPanel, Login, Webmail, and WHM sections of the Theme Manager interface.

Install an addon theme

To install an addon theme, select the Install and Keep Updated checkboxes for the themes that you wish to use, and click Save.

Uninstall an addon theme

To uninstall an addon theme, click Uninstall next to the theme that you wish to remove.

Additional information


When you create your own themes or use a theme that cPanel 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).

We do not support custom themes or localization for WHM.

Additional Documentation