Development Guides Home

Guide to Template Toolkit


Template Toolkit is the main template system for the cPanel and WHM interfaces. This system uses the Template Toolkit Perl library to create templates that can, for example, perform calls to the cPanel APIs and UAPI.

  • Whenever you customize existing template files, we strongly recommend that you back up all of the files before you edit them.
  • This documentation focuses on cPanel & WHM-specific uses of Template Toolkit files. If you have not used Template Toolkit previously, we recommend that you start with's Template::Tutorial::Web tutorial .

Access the Template Toolkit system

Use cptt tags to access the Template Toolkit system from HTML files. cptt tags reference a file that is relative to the /usr/local/cpanel/base/frontend/theme directory, where theme represents the cPanel theme (jupiter or another valid theme on the server).

For example, to call the /usr/local/cpanel/base/frontend/jupiter/templatefile.tmpl file from within an HTML file, use the following code:

<?cptt templatefile.tmpl ?>


HTML files and the .tmpl files that they call must exist in the same directory.