Branding Documentation (pdf)

What is the Branding Editor used for?

The Branding Editor allows you to put your custom logo or look onto any cPanel X theme. You'll need to create images that match the exact sizes of the current images in the branding editor. You can either create a new branding style to make changes in, or change the default style. Then you can upload these images through the editor and they will appear in all of your client's cPanel accounts. Branding is customizable per reseller. If you have multiple reseller accounts, you will need to change the branding for each one as it only affects all accounts owned by that specific reseller account. Using gif images is preferred.

Uploading Images/Text Manually

You can upload images/text for themes that support branding to /home//cpanelbranding/themename.

How Does Branding Work?

Each theme includes branding tags where images would normally be included. These tags search the reseller's cpanelbranding directory for the image. If it does not find the image in .gif, .png, or .jpg format, cPanel will use the default image included with the theme.

Custom Branding

You can add cPanel Branding tags to any page using the following format:
<cpanel Branding="image(image)"> where image is the name of the image you wish to include without an extension. For example <cpanel Branding="image(balloon)"> would work for balloon.jpg, balloon.gif, or balloon.png.

These tags can also be used to add custom text to a theme. <cpanel Branding="text(file)"> will look for a file called file.txt in the cpanelbranding directory and put the contents of that file in the page where the tag is.

Branding Styles

Branding Styles allow you to offer multiple choices to your clients. If you leave the default style untouched, your customers will still have access to it. You can provide different logos, color schemes, icons, etc. for your customers to choose from. Your customers will have access to select any branding style that exists, unless you disable the Change Look and Feel function.