Setting up with Weglot

Umbraco Translator uses Weglot's translation API for the translating itself. The package collects your page's text, sends it to Weglot and renders the result. You still need your own Weglot account and API key.

1. Create a Weglot account and API key

1. Sign up (or log in) at dashboard.weglot.com.
2. Create a project for your site. Weglot gives you an API key that looks like wg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
3. Check your plan's word allowance. Translation calls use it up, and running out is one of the most common reasons translations stop appearing. See Common errors.

2. Add the key to your site

Set WeglotTranslations:WeglotApiKey. See Configuration for the full section. Restart your site after changing it.

3. Add your licence key

On localhost you can skip this step. Anywhere else, set WeglotTranslations:LicenseKey. See Licence key.

4. Add at least one language

The languages table starts empty. Go to Settings → Advanced → Umbraco Translator - Weglot and add the languages you want to offer. See Managing languages.

5. Check it's working

On the same settings page you should see:

• A green "Weglot is up and running" badge in the Weglot API Key panel. This is checked live against Weglot's own status endpoint, from your browser.
• Your API key, masked, in that same panel. If it says "No Weglot API key configured" instead, check step 2 and that the site restarted.
• A licence status in the Umbraco Translator panel. See Checking your licence.

Then click View next to a language. It opens your homepage under that language's prefix (e.g. /fr/), which should come back translated. The first request may take a moment while Weglot translates the page; later requests are served from the cache.

6. Set up your front end

To let visitors find and switch languages, add the switcher partial to your layout or navigation. To help search engines find each language version, add the hreflang partial to your <head>. See Set up your front end.