Page tree
Skip to end of metadata
Go to start of metadata

Introduction

You can create your own custom templates for cPanel's Site Publisher feature.

Create a template

To create an Site Publisher template, perform the following steps:

  1. Create your template's meta.json file.
  2. Create your template files.
  3. Create a preview image for your template. You must save this image as the preview.png file.
  4. Store the template in the appropriate directory on your cPanel & WHM server:
    • Store templates that the root user owns within a template-specific directory in the /var/cpanel/customizations/site_templates/ directory.
    • Store templates that a reseller owns within a template-specific directory in the /home/username/var/cpanel/reseller/site_templates/ directory, where username represents the reseller's username.

      Note:

      We strongly recommend that you do not store additional templates in the cPanel-provided-template directory.

      • In cPanel & WHM version 56 through 68, cPanel-provided templates exist in the /usr/local/cpanel/etc/site_templates/ directory.
      • In cPanel & WHM version 70 and higher, cPanel-provided templates exist in the /usr/local/cpanel/3rdparty/share/site_templates/ directory.

Site Publisher websites

When users publish Site Publisher websites via cPanel's  Site Publisher interface (Home >> Domains >> Site Publisher), the system generates the appropriate website files, and stores them in the target domain's home directory.

Note:

When users publish a Site Publisher website, the system logs template information and the target directory to the /usr/local/cpanel/logs/error_log file.

Each Site Publisher website uses the following assets:

  • The configuration file.
  • Template-specific license files, if the template includes a license.
  • Template-specific generated website files, which may include HTML files, images, fonts, JavaScript files, CGI files, and related subdirectories for these assets.

The system does not publish the template's README files or Template Toolkit files.