Theme Editor

The Theme Editor addon module allows WHMCS Cloud users to create and update custom themes for the WHMCS Client Area. Custom themes provide a seamless experience for your website visitors by customizing the look of the Client Area to match the rest of your website.

For more information about themes in WHMCS, see Themes and Templates.

Activation

The Theme Editor addon module is an exclusive addon module for WHMCS Cloud. To customize themes on a self-hosted WHMCS installation, see our Theme Developer Documentation.

Because WHMCS Cloud includes this addon module by default, you only need to activate it through the Admin Area.

To do this:

  1. Go to Configuration () > System Settings > Addon Modules.
  2. Click Activate for Theme Editor.
  3. Click Configure.
  4. Select the admin role groups that will have access to this addon module.
  5. Click Save Changes.

Using this Addon

You can access the Theme Editor addon module by going to Addons > Theme Editor.

Creating Themes

To create a theme:

  1. Click CREATE A NEW THEME.
  2. For Display Name, enter the desired display name for the theme. This is the name that will display when you select a System Theme value in the General tab at Configuration () > System Settings > General Settings.
  3. For Theme File Name, enter the theme’s filename.
    Theme filenames can only contain alphanumeric characters, hyphens, and underscores.
  4. For Theme Author, enter the name of the theme author.
  5. Click CREATE THEME.

Theme Files

Themes that you create or manage in the Theme Editor addon module include the following customizable files:

  • custom.css — The custom stylesheet for the new theme.
  • footer.tpl — The template for the bottom outer wrapper of the Client Area.
  • header.tpl — The template for the top outer wrapper of the Client Area.
  • homepage.tpl — The contents of the Client Area Homepage.

Editing Themes

To edit a theme:

  1. Choose the theme from the Theme Management menu.
  2. Click on the desired theme file.
  3. Make the desired changes to the file.
  4. Click Save.
The Theme Editor addon module does not validate the changes that you make to these files.

Editing Color Palettes

To edit the color palette for a theme:

  1. Choose the theme from the Theme Management menu.
  2. Click UPDATE COLOR PALETTE.
  3. Edit the hexadecimal codes for individual colors in the theme.
  4. Click Save.

Deleting Themes

To delete a theme:

  1. Select the theme from the Theme Management menu.
  2. Click DELETE THEME.
You cannot delete a theme that is the currently selected System Theme value in the General tab at Configuration () > System Settings > General Settings.

Troubleshooting

For more information on troubleshooting addon module issues, see Troubleshooting Addon Modules.

You may encounter the following common issues:


Error or IssueCauseNext Steps
You cannot delete the active system theme.This error occurs when attempting to delete a theme that is the active System Theme.Theme Deletion Errors
The system could not create the theme.You attempted to create a theme with a name that already exists or contains invalid characters.Theme Editor Creation Errors

Last modified: 2025 October 17