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:
- Create your template's
meta.jsonfile. - Create your template files.
- Create a preview image for your template. You must save this image as the
preview.pngfile. - Store the template in the appropriate directory on your cPanel & WHM server:
- Store templates that the
rootuser 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, whereusernamerepresents the reseller's username.Note:
cPanel-provided templates exist in the
/usr/local/cpanel/etc/site_templates/directory. However, we do not recommend that you store additional templates in this directory.
- Store templates that the
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.
