Customising translations

Machine translation gets most text right, but you'll sometimes want to change a word or phrase, for example to use your own terminology, fix the tone, or correct a mistranslation. You do this in the Weglot dashboard, not in Umbraco.

Where the translations live

Every phrase the package sends to Weglot is stored in your Weglot project, along with its translation for each language. Open your project in the Weglot dashboard and go to Translations to see them, listed per language pair (for example English → French).

The list only contains phrases that have been translated at least once. A page appears there after someone (or something, like a crawler) has requested it under a language prefix such as /fr/.

Changing a translation

1. In the Weglot dashboard, open Translations and pick the language pair.
2. Search for the original or translated text.
3. Edit the translation and save it.

Weglot keeps your edited version and returns it from then on, instead of a fresh machine translation. The edit applies everywhere that exact phrase appears on your site, not just on one page.

Phrases are split by markup

The package sends each block of text to Weglot separately. If a sentence contains a link or other inline element, such as Read our <a>pricing guide</a> today, it's stored as separate entries (Read our, pricing guide, today). Search for a shorter fragment if you can't find a whole sentence.

When changes appear on your site

Translated pages are cached, so an edit appears on the site after that page's cache entry expires, up to CacheDurationInSeconds later. The next request after that calls Weglot again and picks up your edited translation.

To see a change straight away:

• Default in-memory cache: restart the site, which clears every cached page.
• Custom cache (Redis, FusionCache and so on): clear the entries in your cache store.
• While making lots of edits: temporarily set CacheDurationInSeconds to 0 so every request calls Weglot live, then set it back once you're done.

Text that shouldn't be translated at all

If a word should always stay in the original language, like a brand or product name, editing its translation in Weglot works but has to be done per language. It's usually simpler to mark it with data-wg-notranslate in your templates. See Excluding content.