Last modified: March 7, 2022

Overview

This interface allows you to customize parts of the cPanel interface. You can modify the following items:

• Upload custom logos.
• Upload a favicon.
• Update parts of the cPanel interface to match your company’s branding.
• Upload custom cPanel styles.
• Update the contact information on publicly-visible placeholder pages.

For the purposes of cPanel, L.L.C.’s products and documentation, we use the following terms:

Select a theme

The feature allows you to choose a theme. To choose a theme, use the menu to select which theme you wish to customize. You can select the following themes:

• Jupiter
• Paper Lantern (deprecated)

The theme you select will update the features that you can customize.

Jupiter customization options

When you select the Jupiter theme, the interface will show the following options:

Logos

The Logos tab allows you to update the following items:

• A logo for light backgrounds.
• A logo for dark backgrounds.
• A logo description.

To update the logos and description, perform the following steps:

1. Under Company Logo - used with dark background colors, click Browse.
2. Select logo that you wish to use, and click Open. A preview of the logo will appear.
3. Under Company Logo - used with light background colors, click Browse.
4. Select logo that you wish to use, and click Open. A preview of the logo will appear.
5. In the Description text box, enter a description for the image tag.
   Note:

   The information you enter updates the alt text for the logo. Screen readers use this text to describe the page content.
6. Click Update Logos.

Colors

The Colors tab allows you to update the color of cPanel’s Main Menu.

To update the Main Menu color, perform the following steps:

1. Click the Main Menu Background Color text box and use the color wheel to choose the color you prefer. Or, enter the hexadecimal color format that you prefer.
2. Click Update Colors.

To restore the Main Menu’s default colors, click Restore Defaults.

Favicon

The Favicon tab allows you to update the cPanel interface’s favicon.

To update the favicon, perform the following steps:

1. Click Browse.
2. Select favicon that you wish to use, and click Open. A preview of the favicon will appear.
3. Click Update Favicon.

Links

The Links tab allows you to update the Documentation and Help links in the cPanel interface footer.

To update the links, perform the following steps:

1. Enter your preferred link in the Help Link text box.
2. Enter your preferred link in the Documentation Link text box.
3. Click Update Links.

Public Contact

The Public Contact tab allows you to customize the contact information that cPanel & WHM provides for a cPanel account’s default website page and suspended website page.

To update your contact information, perform the following steps:

1. Enter your company’s name in the Public Company Name text box.
2. Enter your company’s contact URL in the Public Contact URL text box.
3. Click Save.

Paper Lantern customization options

When you select the Paper Lantern theme, the interface will show the following options:

Customize Branding

To customize the cPanel or Webmail interfaces:

1. Enter your company’s name in the Company Name text box to brand the interface with your company name.

   Note:

   • This option only exists as part of the Paper Lantern theme. We strongly recommend that you upload an image to use as a company logo and then set alternative text for that image.

   • If you use this option, your company name will appear in the default cPanel font.

   • To change the font style, you must customize cPanel’s CSS with a custom style.

   • The Company Name value cannot exceed 50 characters. The cPanel interface truncates it if the name’s width exceeds the width of the user’s browser window.

2. Enter your help or support URL in the Help Link text box to customize the Help link. The Help link won’t appear in the cPanel interface until you enter a custom URL.

3. Enter your documentation URL in the Documentation Link text box to customize the Documentation link. If you don’t enter a custom Documentation link, the Documentation link points to the cPanel, L.L.C. documentation.

4. Click Browse under the desired heading to add your company logo, Webmail logo, or favicon. Then, select the desired file.

   Note:

   • cPanel & WHM has specific icon size and file type requirements. For more information, read our Guide to cPanel Interface Customization - Custom Icons and Logos documentation.

   • If you upload a file with this interface, the system saves it as an .svg file.

   • To delete an uploaded logo, click the trash can icon () for that image file.

5. To apply your changes, click Save.

Customize Style

Upload a custom style

To upload custom cPanel styles:

1. Click Upload a Style.

2. To select a style to upload, click Browse.

   • The system uses the .tar.gz file’s name as the style’s name.

   • You must upload your custom style as a .tar.gz file, which must contain the styles.css file, the styles.min.css file, or both.

     Note:

     We strongly recommend that you include both files.

3. To set the style as the default style, select the Set this style as my default style checkbox.

4. Click Upload.

   Important:

   We strongly recommend that you keep your custom styles up to date to avoid compatibility issues when you upgrade cPanel & WHM. To do this, perform the following actions:

   • Monitor our Change Logs and our Release Notes documentation for updated features and bug fixes.

   • Make certain that your server runs on the LTS, STABLE, RELEASE, or CURRENT release tiers, so that it receives any functionality updates.

   • You can also use a server that runs on the EDGE release tier to test for compatibility and functionality in a controlled environment.

Manage styles

Use the Manage Styles section to work with styles. To filter the list of styles, click the desired filter name. For each style, you can perform the following actions:

• Set as Default — Click to set a style as the default style for your newly-created accounts.

  Note:

  This action only sets the default for new accounts that you create. It does not set the style for existing accounts on the server.

• Set as Default — Click to set a style as the default style for your newly-created accounts.

  Note:

  This action only sets the default for new accounts that you create. It does not set the style for existing accounts on the server.

• Download Style — Click to download the style. You may wish to download existing styles to customize them or use them as a base for new styles.

• Delete — Click the trash can icon () to delete a style. Then, click Delete again to confirm the deletion.

  Note:

  You can only perform this action on styles that you uploaded and own.

• Delete — Click the trash can icon () to delete a style. Then, click Delete again to confirm the deletion.

  Note:

  You can only perform this action on styles that you uploaded and own.

Public Contact

The Account Suspended and Default Webpage interfaces show visitors this Public Contact information. Users will also see it when they search for your contact information.

• Resellers who own their accounts can add custom information to their main domains.

• Main domains for other resellers use the server owner’s information.

For example, when the system displays a placeholder page to a user, they may see the following message:

If you are the owner of this website, please contact your hosting provider: [email protected]

For information on how to remove this information from the Account Suspended and Default Webpage site templates, read our Web Template Editor documentation.

Customize contact information

To enter your public contact information:

1. Enter your company’s name in the Public Company Name text box.

2. Enter your company’s URL in the Public Contact URL text box.

3. Click Save.

File locations

cPanel & WHM stores branding information in the reseller_info.json file, which exists in either the root user’s or reseller’s brand directory.

• If the reseller who owns the account has specified custom branding information, the cPanel user sees the reseller’s branding in the cPanel interface.

• If the reseller has not specified custom branding information, but the root user has, the cPanel user sees the root user’s branding in the cPanel interface.

• If neither the reseller nor the root user have specified custom branding information, the cPanel user does not see any customizations to the cPanel interface.

When you save your customizations through this interface, the system stores your items in the following directories:

Reseller

Root