Duplicate System Theme Options

Problem

Multiple themes with the same name appear as options for System Theme in the General at Configuration () > System Settings > General Settings.

In particular, you may notice duplicate WHMCS Six Theme options after updating from WHMCS 8.0 or earlier to WHMCS 8.1 or later.

Cause

Two templates have identical names in their respective theme.yaml files.

For example, you may have created a copy of the Six theme in order to create a custom template but forgotten to update the theme.yaml file to rename the custom template.

In WHMCS 8.0 and earlier, the name of the theme’s directory determines the theme name. However, in WHMCS 8.1 and later, the theme.yaml file determines the theme name if it is present.

Solution

Update the custom theme.yaml file to give your theme a distinct name value. You may also want to update the description and author values:

name: "My Custom Theme"
author: "My Company"
properties:
  serverSidePagination: false # Defines client side will handle pagination

troubleshooting system-theme

Last modified: October 30, 2024