branding_theme.exe: Plesk Branding

The branding_theme.exe utility is used for working with custom themes that enable you to change appearance and branding settings for Plesk installations. For detailed information about working with custom themes, refer to the Administrator's Guide > Using Custom Skins.

Location

%plesk_cli%

Usage
branding_theme.exe <command> <option 1> <param>

 

Example

The following command retrieves the Plesk theme package named custom and saves it in a ZIP archive:

branding_theme.exe -p -name custom -destination c:\tmp\custom_theme.zip

 

Commands
Command Parameter Description Example

--pack

or

-p

-name <theme name>

and

-destination <path\filename.zip>

Retrieves the specified Plesk theme package and saves it in a ZIP archive.

To retrieve the default Plesk theme package and save it to the file theme.zip:

branding_theme.exe --pack -name default -destination c:\tmp\theme.zip

 

 

--install

or

-i

-source <path\filename.zip>

Installs a custom Plesk theme from the specified location.

If you do not specify the -vendor, than the theme will be applied to UI only for the Plesk administrator.

When you install the theme, it is automatically applied to UI. To apply another theme that was installed previously, use the --set command.

To install the theme that should be available for the server administrator:

branding_theme.exe --install -vendor admin -source c:\tmp\custom_theme.zip

 

To install the theme that should be available for the reseller with username JDoe:

branding_theme.exe --install -vendor "JDoe" -source c:\tmp\custom_theme.zip

 

--uninstall

or

-u

-name <theme name>

Removes a specified custom Plesk theme.

The name <theme name> is the name specified in meta.xml file of the theme archive.

To remove a theme named green:

branding_theme.exe -u -name green

--set

or

-s

-name <theme name>

Activates one of the installed Plesk themes: The specified theme will be applied to Plesk UI.

This theme should have been installed and has the name <theme name> specified in its meta.xml file.

If you do not specify the -vendor, than the theme will be applied only to UI for the Plesk administrator.

To apply the theme green to the Plesk UI for the reseller with username JDoe:

>branding_theme --set -name green -vendor "JDoe"

--list

or

-l

 

Displays the list of all installed Plesk themes.

To view the list of all installed themes:

branding_theme.exe --list

--help or -h

 

Displays a help reference for the utility.

To see the help info on the use of this utility:

branding_theme.exe --help

or

branding_theme.exe -h

 

Options
Option Parameter Description Example

-name

<theme name>

Specifies the name of a custom theme. This is the name specified in meta.xml file of the theme archive.

Required with the -pack and -uninstall commands.

To install the theme with the name mytheme that should be available for the server administrator form the file custom_theme.zip:

branding_theme --install -name mytheme -vendor admin -source c:\tmp\custom_theme.zip

 

-source

<path\filename.zip>

Specifies the path to a ZIP file with a custom theme.

Required with the -install command.

-vendor

<username>

Specifies whether the theme is related to the server administrator or a reseller.

Used optionally with the --install and --set commands. If you do not use this option, the theme will be related to the Plesk administrator.

-destination

<path\filename.zip>

Specifies the path and file name for saving the theme.

Required with the -pack command.

To retrieve the Plesk theme package named green and save it to the file greentheme.zip:

branding_theme.exe --pack -name green -destination c:\tmp\greentheme.zip