Domain Categories

This page describes a feature available in version 7.10 and above.

What are domain categories?

Domain Categories are used in the client area to group domain TLDs into categories such as "Popular", "Shopping", or "Real Estate" and makes it easier for clients to navigate and find their ideal domain extension.

How do I customise the domain categories?

The domain categories shipped with WHMCS by default can be found in /resources/domains/dist.categories.json. This file should not be edited.

To add or edit domain category definitions, begin by creating a custom categories.json file located at /resources/domains/categories.json.

Inside it, define the domain categories you wish to use. This file will remain in place when updating WHMCS.

TLDs can appear in multiple categories; for example, a UK-based company might include .UK and .CO.UK TLDs in the "Popular" category as well as a "Local Geographic" category.

Adding a TLD/Category

Inside your custom /resources/domains/categories.json file, add a section that resembles this example:

{
    "Awesome Domains": [
        ".whmcs",
        ".whmcstest"
    ]
}

This example adds a domain category called "Awesome Domains" with the ".whmcs" and ".whmcstest" domain TLDs.

A domain category definition is simply the category name, with an array of the domain TLDs which should be included in that category.

Removing a TLD from a default TLD Category

Inside your custom /resources/domains/categories.json file, add a section that resembles this example:

{
"REMOVE": {
    "Popular" : [
        ".com", ".net"
    ]
},

This example removes the .com and .net TLD from showing in the default Popular category.