Create Custom Icons For CHM Output

It is possible to customize the icons used in the HTML Help 1.x viewer. In order to do this, it is necessary to deploy a specifically formatted icon bitmap file along with your .chm and change the default template HTML Help project file.

  1. Download a copy of the standard HTML Help 1.x icon bitmap file: defaultchmiconstrip.bmp
  2. Customize the icons to your requirements using an image editor.    
  3. Modify the template used for generating the HTML help project file in notepad. The filename is c:\program files (x86)\innovasys\DocumentX2019\configuration\templates\help1\default\template.hhc for Document! X users, and is c:\program files (x86)\innovasys\HelpStudo2019\configuration\templates\help1\default\template.hhc for HelpStudio users.
  4. Edit the template.hhc file to include the required custom icon reference, e.g. change this:

    <OBJECT type="text/site properties">
       <param name="FrameName" value="right">

    .. to this:

    <OBJECT type="text/site properties">
       <param name="FrameName" value="right">
       <param name="ImageList" value="file:/%systemroot%\customhelpicons.bmp">
       <param name="Image Width" value="16">
       <param name="Color Mask" value="0xff00ff">

  5. When you deploy your CHM file you must also deploy the customhelpicons.bmp file and copy it to the C:\Windows folder. This is necessary to avoid having to specify an absolute path to your custom icons file.


The format of the custom bitmap file has restrictions. The icons can only contain 8 colors and the bitmap size must be exactly the same size as the default icon bitmap.

HelpStudio / Document! X will not show your custom icons when designing the Table of Contents - they will only show up when you build your CHM.

At present, you must repeat this edit to the template.hhc file if you install an update to Document! X or HelpStudio.



Have more questions? Submit a request


Please sign in to leave a comment.