HelpScout - Integration / Setup
Translate your HelpScout docs
Translate all your content and make your HelpScout docs multilingual within minutes.
1. Create a Weglot account
Your Weglot account is where you’ll have all your translations and where you can manage/edit them. Simply create a Weglot account here.
2. Create your project and enter your domain name and the languages you want
Once you created your account, you have to create your project. You must give it a name, and select the technology of your website. Here, we will go with "Other" :
Then, click on the "Next" button.
In the following step, simply enter your domain name and the language you want to translate your website into (DO NOT USE your HelpScout sub-domain ending with .helpscoutdocs.com). Then, click “Next” to go to the next step.
For example:
- my domain is: support.mydomain.com
- the original language is: English
- the translated language is: French
If you don’t want to configure the subdomains yet, you can skip it by selecting “Use JavaScript integration” on your Weglot installation page (if so, go directly to step 4). You can set up your subdomains to have SEO-friendly docs later.
3. Configure the subdomains in your DNS records
Here comes the most important step: you will add new entries to your DNS (Domain Name System) record to connect Weglot to your Help Scout subdomain and be able to have dedicated URLs for each language. The subdomains will display the translations of your docs once configured!
Go to your DNS provider where you manage the domain name of your Help Scout docs (like GoDaddy, 1&1, Google Domain, etc…).
If you are using GoDaddy, Google Domains, Namecheap, or Hostinger you can see how to do it in the videos below:
Godaddy --> https://www.youtube.com/watch?v=9407vj9pXbY
Google Domains --> https://www.youtube.com/watch?v=t0vbawaPUN4
Namecheap --> https://www.youtube.com/watch?v=syC5EGllqrs
Hostinger --> https://www.youtube.com/watch?v=j7aPlUQtNCk
Access the DNS section to add the 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 add the second entry 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.
When you’ve added and saved your entries, go back to 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”.
4. Install the Weglot library
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 not see the “Manage” tab it means you do not have permission to access it. Ask for more permissions or ask the person in charge of your Help Scout account).
Select the Docs Site you want to translate, then click on “Custom Code” on the left bar menu
Click in the Insert <head> Code field, go to the very end of the field, and paste the JavaScript code provided to you. Then click on save.
5. It’s done!
Go to your website, 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 website is now translated! You can now go to your Weglot dashboard to manage all your translations.