Submit a ticketCall us

Training Class Getting Started with SolarWinds Backup - February 28

This course offers customers an introduction to SolarWinds Backup, focusing on configuring the backup technology, taking backups, data restoration and data security. It is a great primer and will get you up to speed quickly on SolarWinds Backup.
Register for class.

Home > Success Center > Web Help Desk (WHD) > Customize the Web Help Desk GUI language and labels

Customize the Web Help Desk GUI language and labels


Updated November 10, 2017


This article describes how to customize the Web Help Desk GUI language and labels.


All WHD versions


  1. Navigate to your Web Help Desk home directory.
    Apple® macOS®/Library/WebHelpDesk    
    Microsoft® Windows®:  \Program Files\WebHelpDesk    
    Linux:  /usr/local/webhelpdesk
  2. Navigate to /conf/labels and open the file in a text editor (such as Notepad++). 

    This is the default labels file that contains all default labels used by the application. Do not edit this file. View the contents and locate the labels you need to change.

  3. In the /labels directory, create a custom labels file named

    This file will only include the labels you need to change. The application will use the default labels for any value not found in the file.

  4. Copy the label entries you need to change from the file to the file. 
    For example, to change the label for Ticket to read Job, enter lbl.ticket=Job in the file. 

    If you cannot find the label in the file, you cannot modify the label.

  5. Rename the file to, removing the .txt extension. 

Supporting additional languages

You can create additional files for specific locales by prefixing .properties with a language and country code as specified by ISO 639 and 3166. For example, to define custom labels for Spanish clients, create a file named in the /labels directory and add your custom label definitions. 

To define label specifically for Mexican Spanish, name the file

Web Help Desk queries the files starting with the most specific match. For example, if a Spain client submits a request, the application will access the following files in order until it can define the label:


For complete listings of ISO 369 and 3166 language and country codes, see:


Oracle Java requires properties files to be in Latin-1 or escaped Unicode format, where Unicode characters are represented by Unicode escape sequences. You can use the native2ascii Java tool to convert native-encoded files to to this format. This tool is located at <WebHelpDesk>/bin/native2asciiAdditionally, UTF-8 encoding does not use Unicode escape sequences. Use the native2ascii tool convert UTF-8 encoded files. 

Java tool syntax

The native2ascii tool uses the following syntax: 

native2ascii -encoding "<encoding_name>" [input_file] [output_file]</encoding_name

For example, to convert a file encoded in Shift-JIS to escaped Unicode, execute the following command:

native2ascii -encoding "SJIS"

See native2ascii - Native-to-ASCI Converter ascii on the Oracle website for a list of supported encoding and instructions on using the native2ascii tool. (© 2017 Oracle Corporation, available at, obtained on November 11, 2017)


Disclaimer: Please note, any content posted herein is provided as a suggestion or recommendation to you for your internal use. This is not part of the SolarWinds software or documentation that you purchased from SolarWinds, and the information set forth herein may come from third parties. Your organization should internally review and assess to what extent, if any, such custom scripts or recommendations will be incorporated into your environment.  You elect to use third party content at your own risk, and you will be solely responsible for the incorporation of the same, if any.


Last modified