Datapad.UmbracoAutoTranslator 1.0.5

Umbraco AutoTranslator

An Umbraco 17 backoffice package that translates content node properties — including Block Grid and Block List blocks — between language variants. Ships with a Google Cloud Translation provider out of the box, plus a pluggable ITranslationProvider interface so you can wire DeepL, OpenAI, Azure, or any other translation backend.

What you get

• A workspace action ("Translate from…") on the Document workspace that translates the current variant from another variant of the same node.
• A property action ("Translate block") on Block Grid / Block List properties that translates a single property's blocks.
• A Management API endpoint: POST /umbraco/management/api/v1/translator/content/{key}/translate.
• A license dashboard under Settings → Translator license to manage your activation key and inspect trial / license status.
• A Block Grid / Block List JSON walker that recursively translates contentData (and optionally settingsData) string values across nested block payloads.
• Two translation providers shipped:
  • echo — development stub. Prefixes text with the target culture. Default.
  • google-cloud-translation — Google Cloud Translation v2. API-key auth. Recommended for production.

Install

dotnet add package Datapad.UmbracoAutoTranslator

Licensing

Umbraco AutoTranslator is commercial software. A 1000-word free trial runs out of the box — no key required. Translation beyond the trial requires an active license key (issued keys start with AT-).

• Buy or manage licenses: https://projects.datapad.nl/projects/autotranslate
• Activate, inspect, or clear keys from the backoffice Settings → Translator license dashboard.

Configure

The default DefaultProviderAlias is "echo" on a fresh install so the package boots without configuration. Switch to a real provider once you have credentials.

{
  "Umbraco": {
    "UmbracoTranslator": {
      "DefaultProviderAlias": "google-cloud-translation",
      "TranslateBlockGridContents": true,
      "TranslateSettingsData": false,
      "SkipPropertyEditorAliases": [],
      "GoogleCloud": {
        "ApiKey": "AIza..."
      }
    }
  }
}

The configuration section is Umbraco:UmbracoTranslator (internal binding key) even though the NuGet package id is Datapad.UmbracoAutoTranslator.

Google Cloud Translation

1. Enable the Cloud Translation API in a Google Cloud project: https://console.cloud.google.com/apis/library/translate.googleapis.com.
2. Create an API key restricted to the Cloud Translation API: https://console.cloud.google.com/apis/credentials.
3. Paste the key into GoogleCloud.ApiKey and set DefaultProviderAlias to "google-cloud-translation".

Format support

Add your own provider

Implement ITranslationProvider and register it in your composer:

builder.Services.AddSingleton<ITranslationProvider, MyDeepLProvider>();

Then set DefaultProviderAlias to the provider's Alias value.

Translate a node via API

POST /umbraco/management/api/v1/translator/content/{key}/translate
Content-Type: application/json

{
  "sourceCulture": "en-US",
  "targetCulture": "nl-NL"
}

Authenticated using the standard BackOfficeAccess policy.

Links

• Product page: https://projects.datapad.nl/projects/autotranslate
• License: see LICENSE.md