SmarterMail 3.x Help
This documentation is for a product that is no longer supported by SmarterTools.

Skinning Guide

SmarterMail allows you to customize its look and feel to suit your own needs. Instructions on skinning the web interface can be found below, as well as some notes that are important to understand.

Skinning Process

  1. Download the base skin module. Click here to download
  2. Extract the contents into a temporary folder.
  3. Modify the files using any of the common HTML / CSS editors on the market to adapt it to the look you want. Keep all tags that are surrounded by [brackets]. These are where controls will be added that contain the sidebar elements, body content, etc. For more details on each of the files and tags, see the section below.
  4. If desired, change any of the images in the Images directory.
  5. Edit the Skin.xml file with notepad or an XML editor and modify the following:
    • Title - Input the title of your skin.
    • Author - Input your name, or the name of your company.
  6. Save all files and make a new zip archive that contains all of the files. The structure of the zip file needs to remain the same as the file you downloaded.
  7. Log in to SmarterMail as the administrator.
  8. Upload your skin in Settings - Skins, which will make it available to select as an active skin.


  • The name of the product (SmarterMail) must remain visible in the skin. You may use a term like "Powered by", but the reference to SmarterMail must exist on the page.
  • The [Copyright] tag must exist in the page, and must remain visible in the skin.

Skin Files

  • Skin.xml - This XML file establishes the general properties of the skin, most notably the author and name of the skin. In the event that you give your skin to others, this helps to identify who made the skin.
  • Login.htm - The template used for the display of the login page.
  • Plain.htm - The template for the inner frame where messages are viewed, as seen when reading a message.
  • Standard.htm - The template that is seen most of the time in SmarterMail, with a sidebar and a top menu.
  • SysAdmin.htm - The template seen by the system administrator, with a sidebar and a top menu..
  • Calendar.css - This style sheet establishes the look and feel of the popup calendar.
  • Layout.css - General layout styles are contained in this style sheet, including colors, etc. You may modify the styles, but do not delete any styles from this file to ensure proper operation of SmarterMail.
  • LayoutPlain.css - Layout styles for the Plain.htm file are contained in this file. You may modify the styles, but do not delete any styles from this file to ensure proper operation of SmarterMail.
  • Skin.css - Skin-specific styles reside in this file. You may alter it as you see fit.

Bracket Tags

  • [PAGETITLE] - Inserts the title of the page. This is most frequently used between <title> tags.
  • [HEADITEMS] - Required placeholder for additional items that SmarterMail needs to add to each page. Must be contained withing <head> tags.
  • [LOGGEDINAS] - Sidebar box for "Logged In As".
  • [FOLDERLIST] - Sidebar box for the folder list, or the real time statistics if user is the system administrator.
  • [SEARCHBAR] - Sidebar search box that allows searching of domains for system administrators or email messages for other users.
  • [PRODUCTNAMEANDVERSION] - Text for "SmarterMail Professional Edition" + version. It is required to use this tag in the skin.
  • [DOMAINTITLE] - The name of the domain that is logged in to.
  • [TIPTEXT] - Placeholder for where errors and messages will appear in response to actions.
  • [BODY] - Placeholder for the main inner content of the page. This is the big white area in the default skin.
  • [COPYRIGHT] - This field is also required to be included and visible in the skin. Displays the SmarterMail copyright.
  • [FOOTERCONTENT] - Used by SmarterMail internally. This tag must remain in all files in which it appears.
  • [MENU] - Placeholder for the main pull-down menu.