Skip to main content

Troubleshooting

How to enable debugging for the plugin?

Set WebsiteTranslator.Options.debug=true.


The language selector is not displayed

Make sure you have added an element with class="website-translator" to your page.

<div class="website-translator"></div>

My website is not being translated

1. The language is not set

Check if the language is declared correctly in HTML. Your HTML should have lang attribute defined. Website translator supports ISO 639-1 language codes with optional ISO 3166-1 alpha-2 country codes.

2. The contents have not been loaded

Make sure the contents of the page have been loaded before initializing the Website translator. Different methods can be used to determine if the page has been loaded.

$(document).ready(function() {
...
WebsiteTranslator.Initialize()
})

For static websites it is recommended to place the Website translator configuration script at the end of the body tag.


Some parts of the website are not being translated

Check if the elements in question are not marked as a different language, e.g. lang=”de” in an english language page. Check if the elements are not marked as untranslatable either with class="notranslate" or translate attribute.

<p translate=”no”> or <p class=”notranslate”> 

Make sure the content is fully loaded, see "My website is not being translated".


Language of the Website translator’s UI keeps changing

The language of the UI by default is set to the language you are translating into. Set WebsiteTranslator.Options.ui.translate=”source” if you want the translation bar and popups to be in the website’s original language.


Website translation is slow / Translation makes the page load slower

First time the content of any page is loaded it will take some time to translate it. The translation will be saved in a translation database and will load faster the next time.

To make it load faster for the visitors it is recommended to "pre-translate" all the pages of your website. Go through pages, selecting each language from the Website translator's language selector to translate them.


Translation timed out

Waiting for the response from the translation engine took too much time. You can retry translating later.


The Website translator doesn’t look right/ There are problems with the styles

Globally set CSS styles can affect the appearance of the website translator. You can restyle it with CSS and fix the issues.