Freshdesk supports multiple languages so you can offer global assistance. This article explains how to set up your help widget for multilingual support.


This is article 3 of 3 about the Freshdesk Help Widget:
  1. Set up your help widget
  2. Advanced configurations with the help widget API
  3. Support multiple languages in your help widget


This article contains:


Configure multilingual support in your help widget

To set up your widget in multiple languages, do the following in order:

  1. Set up another language in your Freshdesk account. See Manage Languages.
  2. Translate your contact forms.
    1. If you use the Simple Form, we'll translate it for you.
    2. If you use a form with ticket fields, see Multilingual ticket fields and forms.
  3. Translate your solution articles. See Setting up a Multilingual Knowledge Base.
  4. Use the setLabels API alongside your embed code to translate any of the following labels that you use:
    1. Widget launcher text
    2. Widget banner message
    3. Contact form title
    4. Contact form submit button
    5. Contact form confirmation message
    6. Frustration tracking banner message
    7. Frustration tracking description
    8. Frustration tracking confirmation

For example, the following code provides a French and Spanish translation for the Contact form title.

FreshworksWidget("setLabels", {
          'fr': {
            contact_form: {
              title:"Contactez nous"
            }
          },
          'es': {
            contact_form: {
              title:"Contáctenos"
            }
          }
        });


The help widget doesn't support right-to-left languages such as Arabic and Hebrew.



Load the widget in another language

Freshdesk uses browser-based detection to show a particular language to a user. If the language of your browser matches one of the supported languages in your Freshdesk account, then the contact form and solutions will load in that language.


You can also force the widget to load in a certain language by setting the 'locale' property in the widget's embed code. The locale property overrides the end user's browser language. For example, the following code loads the widget in German:

<html>
  <body>
    <script>
      window.fwSettings = {
        'widget_id':12000000025,
        'locale': 'de'
      };
      !function(){
         if("function"!=typeof window.FreshworksWidget){
          var n=function(){n.q.push(arguments)};
          n.q=[],window.FreshworksWidget=n}
       }()
    </script>
    <script type='text/javascript' src='https://widget.freshworks.com/widgets/12000000025.js' async defer />
  </body>
</html>


For further help, see the API documentation or contact [email protected].