You can find our user documentation at docs.cpanel.net.

Check out our new API beta site!

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

Excerpt
You can develop custom styles that modify the appearance of the cPanel interface.
 For example, you may wish to create a customized appearance to match your company's branding and logo, or you may wish to create customized styles for distribution.


Note
titleNotes:
  • A custom cPanel style only changes the appearance of the cPanel interface, while cPanel plugins add customized functionality. For information about how to create cPanel plugins, read our Guide to cPanel Plugins documentation.
  • For a step-by-step tutorial about how to create and apply a custom style, read our Tutorial - Create a Custom cPanel Style documentation.

Warning
titleImportant:
  • Include Page
    LIB:_StyleUpdate
    LIB:_StyleUpdate
  • We strongly recommend that you do not attempt to modify the existing cPanel default style. Updates to cPanel & WHM may overwrite your changes. To modify any aspect of the cPanel interface's appearance, you must create a new style.

Style development workflow

Include Page
LIB:_StyleExample
LIB:_StyleExample

When you create a cPanel style, we recommend that you use the following workflow:

  1. Create a new directory for the style.

  2. Create the styles.css file within the new directory.

    Note
    titleNote:

    In cPanel & WHM version 60 and later, you can also use the styles.min.css file. We strongly recommend that you include both the styles.css and styles.min.css files.


  3. Add the desired images and other assets to the directory.

  4. Perform one of the following actions to add the style to the server and apply it to accounts:

    • Move the style's directory to the appropriate location on the server, and then apply the style to the desired accounts:

      Multiexcerpt
      MultiExcerptNameDirectories
      • For all of the accounts on the server — /var/cpanel/customizations/styled/mystyle/

      • For all of the cPanel accounts that a reseller owns — /home/reseller/var/cpanel/reseller/styled/mystyle/

      • For a specific cPanel account — /home/username/var/cpanel/styled/mystyle/

      Note
      titleNotes:
      • mystyle represents the name of the style's directory.
      • reseller represents the reseller's username.
      • username represents the cPanel account's username.
      • If the server uses a customized home directory path, make certain that you use the appropriate path for that home directory.
      • If these directories do not currently exist on the server, use the mkdir command to create them.



    • In cPanel & WHM version 60 and later, use WHM's  Customization interface (WHM >> Home >> cPanel >> Customization) to upload and apply your style.
    • In cPanel & WHM version 66 and later, use the /scripts/modify_accounts script to apply a specific style and theme across multiple existing accounts.
Note
titleNote:

The system uses the cpsrvd daemon to serve cPanel styles. The cpsrvd daemon listens on port 2082 (insecure connections) and port 2083 (secure connections). Make certain that you consider these requirements when you specify paths in your custom styles.