Branding

Revision as of 14:15, 9 April 2018 by Ltalaschus (talk | contribs)

The appearance of MailStore Client, MailStore Web Access, and MailStore Outlook Add-in can all be easily customized to match your corporate design.

Modify and Activate Branding

Follow the instructions below to apply your own branding:

  • Open Windows Explorer on the Management Server.
  • Navigate to the config subdirectory of the MailStore Service Provider Edition installation. (Default: %PROGRAMFILES%\MailStore Infrastructure\config).
  • Create a new folder named Branding.
  • Store all files necessary for branding in this newly created folder. Find further details about the branding parameters in Client Branding and Web Branding below.
    Important notices: The dimensions of the images must remain unchanged and no syntax errors must be made when editing JSON files. If necessary, test the JSON files at http://jsonlint.com/. Sample files can be found in the ‘Branding.sample’ folder located in the config subdirectory. The about.html file needs to have an UTF-8 BOM (byte order mark) or else it cannot be loaded.


  • Restart the Management Server service to activate the new branding.
  • Finally restart all the Client Access Server service on all server to refresh their local caches.

Client Branding

The following table provides information about the fields available for MailStore Client branding stored in ClientBranding.json.

Name Description
clientName Name of the client application, e.g. "YOURCOMPANY - EMAIL ARCHIVE"
helpUrl URL to be opened when clicking on help in client.
loginHeaderImage_410x81_png Header image for login dialog. Required dimension: width: 410px; height: 81px
headerBackgroundColor Background color of header, e.g. "#126d9c"
headerLeftImage_autox95_png Left header image. Required dimension: width: auto; height: 95px
headerRightImage_autox95_png Right header image. Required dimension: width: auto; height: 95px
about_html HTML file containing the about site.
watermarkImage_300x150_png Watermark image. Required dimension: width: 300px; height: 150px

Web Branding

The following table provides information about the fields available for MailStore Web Access and MailStore Outlook Add-in branding stored in WebBranding.json.

Name Description
webName Name of the web application, e.g. "YOURCOMPANY - EMAIL ARCHIVE WEB ACCESS"
webAbout_html HTML file containing the about site.
webRoot_html HTML file to be used when no in instance was given in the URL.
webHelpUrl URL to be opened when clicking on help in web access.
webLoginHeaderImage_410x81_png Header image for login dialog. Required dimension: width: 410px; height: 81px
webHeaderBackgroundColor Background color of header, e.g. "#126d9c"
webHeaderBackgroundImage_autox36_png Header header image. Required dimension: width: auto; height: 36px
outlookAddinName Name of the Outlook Add-in, e.g. "YOURCOMPANY - EMAIL ARCHIVE ADD-IN".
outlookAddinHelpUrl URL to be opened when clicking on help in Outlook Add-in.
watermarkImage_300x150_png Watermark image. Required dimension: width: 300px; height: 150px
favicon_ico Favicon in 16x16, 32x32, 64x64 pixel.
favicon_png Favicon in 196x196 pixel in PNG format.
highlightColor Color used for section titles, buttons and other controls, e.g. "#6aabce".