helpscout-logo2

It’s always a great moment when your company starts to grow and to reach customers outside of your home country. But it involves new responsibilities: your new foreign customers are expecting a support level as good as your first users even if they speak another language!

If you’re using Help Scout to handle all your customer communication (Great choice, we use Help Scout too!), you might want to translate your Public or Private docs in several languages. Weglot is the perfect solution for it. We’ve developed a simple way to detect all your Help Scout docs and translate it in any language you want.

What makes Weglot better?

Weglot indexes all your translated docs on Google so your users can find the right answer to their questions in their own language directly on Google. Our innovative subdomain integration makes it easy to index all your translated pages on Google.

Key Benefits

See Weglot in action

Interested to see how Weglot works with Help Scout docs? Check out our own support docs!

weglot_helpscout_demo_example

Our support documents are created in English as normal Help Scout docs and then translated in French with Weglot. You can change the language with the language switcher at the bottom-right corner of the website.

Let’s translate your Help Scout docs

1. Create a Weglot account (~ 1 minute)

Your Weglot account is where you’ll have all your translations and where you can manage/edit them. Simply create a Weglot account here.

translate-website-guide-register

2. Enter your domain URL and the language desired (~ 1 minute)

In this step, simply the domain where your Help Scout docs are located and the language you want to translate it into.

For example:
– my docs are located on the subdomain: support.mydomain.com
– the original language is: English
– the translated language is: French

Click “Next” to go to the next step.

IMPORTANT: DO NOT USE your Help Scout sub-domain ending with .helpscoutdocs.com. If you don’t have a custom domain yet or if you don’t want to configure the subdomains now, you can skip this by selecting “Use JavaScript integration” on your Weglot installation process. If so, go directly to step 5 of this guide. You can setup your subdomains to have SEO-friendly docs later.

3. Configure the subdomains in your DNS records (~ 5 minutes)

Here comes the most important step: you will add new entries to your DNS (Domain Name System) records to connect Weglot to your Help Scout docs. The subdomains used will display the translations of your docs once configured!

Go to your DNS provider where you manage the domain of your Help Scout docs (like GoDaddy, 1&1, Google Domain, etc…). Access the DNS section to add new entries and copy/paste the entries shown to you in the Weglot installation process.

IMPORTANT: If your Help Scout docs are already on a subdomain like support.mydomain.com, you need to change the second entries from fr.mydomain.com to fr.support.mydomain.com.

If you are not sure how to do it or where it is, we can help you. Just email us at support@weglot.com.

4. Validate the DNS entries

When you’ve added and saved your entries, go back your Weglot account tab, click “Check DNS” and you should have two green check icons, it means the DNS entries were successfully configured. Then, click on “Next”.

weglot_dns_entries_check

5. Install the Weglot library (~ 3 minutes)

This is the very last step of the installation process. We will add a little JavaScript code snippet so we can display a language button on your website to easily change languages.

Go to your Help Scout account, then click on “Manage” in the top left menu and select “Docs” (if you can’t see the “Manage” tab it means you don’t have the permission to access it. Ask for more permissions or ask the person in charge of your Help Scout account).

weglot_helpscout_js_1

Select the Docs Site you want to translate, then click on “Custom Code” on the left bar menu:

weglot_helpscout_js_2

Click in the “Insert Code” field, go the very end of the field, and paste the JavaScript code provided to you. Then click on save.

6. It’s done!

Go to your Help Scout docs, and you should see the language button at the bottom right. It might take a few minutes to appear so don’t hesitate to wait a bit.

Try changing the language when the language switcher appears, your Help Scout docs are now translated! You can now go to your Weglot dashboard to manage all your translations.