Guide to cPanel Interface Customization - Custom Icons and Logos


You can add one or more custom icons or logos to your custom cPanel style.  If you add a custom logo to your style, cPanel users will see your custom logo instead of the default cPanel logo.

The root user can add custom logos that resellers and cPanel userscannot override. If the root user has not set a server-wide custom logo, resellers can add a custom logo for the accounts that they own. This logo displays in the cPanel interface's header, and replaces the default cPanel logo.


We recommend that you use a 250 by 50 pixel logo.

To add a custom logo for all of the accounts on the server, save the desired logo as the logo.png file in the /var/cpanel/customizations/brand/ directory.  

  • This action requires root-level permissions on the server.
  • If the /var/cpanel/customizations/brand/ directory does not already exist, you must create it. 

To add a custom logo for all of the accounts that a reseller owns, save the desired logo as the logo.png file in the /home/username/var/cpanel/reseller/brand/ directory, where username represents the reseller's username.

  • If the /home/username/var/cpanel/reseller/brand/directory does not already exist, you must create it. 
  • If the server uses a customized home directory path, make certain that you use the appropriate path for that home directory.

Add custom icons


To replace the default cPanel icons with your own icons, perform the following steps:

  1. In your style's directory, create the icons subdirectory.
  2. Save your icons with the same name and file extension as the feature icons that you wish to replace. 
    • For example, to replace the File Manager icon, save your icon as the file_manager.png file.
After you apply a style that uses custom icons, run the following command, where mystyle represents the style name:


/usr/local/cpanel/bin/sprite_generator --theme paper_lantern --style mystyle

The  /usr/local/cpanel/bin/sprite_generator  utility integrates your icons into the new icon set.

Add a preview image


To add a preview image to your custom style, save the image as the preview.png file within the style's directory.

  • cPanel's  Change Style interface (Home >> Preferences >> Change Style) will display this image with the options for the style.
  • We recommend that you use a 500 by 500 pixel image as the preview image.


Images in custom style CSS

After you apply a style, the system generates the current_style symlink in the style directory. The current_style symlink always points to the active style that the user selected in cPanel's  Change Style interface ( Home >> Preferences >> Change Style ). If you use the /styled/current_style path to link external styles in your styles.css file, the cpsrvd daemon queries the current style for those assets.

For example, to add a background image that links to your current style to the cPanel interface, include the following CSS statement in the styles.css file:

body {
  • 6 Users Found This Useful
Was this answer helpful?

Related Articles

The cPanel Interface

For  cPanel  &  WHM  version  58 Overview The cPanel interface is...

User Preferences

For cPanel & WHM version 58 Overview This document outlines how to access your cPanel...

Manage External Authentications

For cPanel & WHM version 58 Overview Manage credentials Additional documentation...

What is cPanelID?

In This Article:  Overview ServicesHow to get a cPanelID cPanelID External...

Guide to cPanel Interface Customization - cPanel Style Development

Introduction You can develop custom styles that modify the appearance of the cPanel interface....