Diplo.Translator
17.1.0
dotnet add package Diplo.Translator --version 17.1.0
NuGet\Install-Package Diplo.Translator -Version 17.1.0
<PackageReference Include="Diplo.Translator" Version="17.1.0" />
<PackageVersion Include="Diplo.Translator" Version="17.1.0" />
<PackageReference Include="Diplo.Translator" />
paket add Diplo.Translator --version 17.1.0
#r "nuget: Diplo.Translator, 17.1.0"
#:package Diplo.Translator@17.1.0
#addin nuget:?package=Diplo.Translator&version=17.1.0
#tool nuget:?package=Diplo.Translator&version=17.1.0
Diplo Translator for Umbraco
Diplo Translator is an Umbraco 17 package for AI translating Umbraco Dictionary items from the backoffice using Umbraco.AI. You can quickly translate the entire Dictionary in just a couple of clicks using your AI model of choice.
This v17 release is a rewrite for Umbraco 17 and .NET 10. It replaces the older AngularJS and Microsoft Translator integration with a Lit backoffice extension, Umbraco Management API endpoints, and Umbraco.AI chat providers.
Need to translate pages too?
This Dictionary translation package remains free and open source. Diplo Translator Omni is a separate commercial package for page and section translation, supported rich text and blocks, draft review, source-change tracking, glossary rules and coverage reports. There is no in-place upgrade; follow the separate installation guidance. Running both packages together is not supported. AI provider usage costs are separate for both packages.
Features
Adds a Translate action to the Dictionary tree.
Adds a Translation dashboard with missing-value counts and an introduction to Omni.
Choose the whole Dictionary, one item, or an item and its descendants.
Select target languages and preview the work before making AI calls.
Checks supported placeholders before saving; download a JSON report after the job finishes.
Translates missing Dictionary values from a selected source language.
Optional overwrite mode for replacing existing translated values.
Uses Umbraco.AI chat profiles, including the host site's default profile.
Runs translations as a background job with progress polling in the backoffice modal.
Refreshes the Dictionary overview after a successful translation.
Continues processing if an individual Dictionary item fails and reports per-item errors.
Dictionary values save directly, without a draft stage. Jobs and reports expire 30 minutes after completion and are lost on restart; reports retain up to 10,000 outcome rows and indicate truncation. See the contributor and usage documentation for permissions, placeholder formats and cancellation behavior.
Requirements
- Umbraco 17
- .NET 10
- An Umbraco.AI provider installed and configured in the host site, for example
Umbraco.AI.OpenAI - At least two languages configured in Umbraco
Installation
Install the package into your Umbraco 17 site:
dotnet add package Diplo.Translator
The package ships its backoffice assets under:
/App_Plugins/DiploTranslator/
Umbraco.AI Setup
Configure Umbraco.AI in the host site as normal with at least one provider (it is free and open source).
- Diplo Translator uses
IAIChatService, so it will use the configured chat provider and chat profile from Umbraco.AI.
By default, the package allows Umbraco.AI to resolve the default chat profile. To use a specific chat profile, add this to appsettings.json:
{
"DiploTranslator": {
"ChatProfileAlias": "your-chat-profile-alias"
}
}
Leave ChatProfileAlias empty or remove it to use the default Umbraco.AI chat profile.
Note: When selecting a model, use something small and fast like gpt-4.1-nano
Usage
Open the Umbraco backoffice and go to the Dictionary tree.
Use the Translate entity action on the Dictionary root or a Dictionary item. The action opens a modal where you can:
- choose the source language
- choose whether to overwrite existing target values
- start the translation job
- watch progress and item errors
The source language defaults to Umbraco's default language where possible.
Screenshots
Track Progress

Completion Summary

Refreshed Dictionary Overview

Diplo Translator Omni
Diplo Translator Omni is new commercial package for translating entire Umbraco websites, with support for rich text and blocks, draft review, source-change tracking, glossary rules and coverage reports. See the Omni documentation for more information.
Links
- Source: https://github.com/DanDiplo/Diplo.Translator/tree/v17
- Issues: https://github.com/DanDiplo/Diplo.Translator/issues
- Umbraco.AI docs: https://docs.umbraco.com/ai-in-umbraco
- Diplo Translator Omni: https://translator.diplo.co.uk/
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Umbraco.AI (>= 1.10.1)
- Umbraco.Cms.Api.Management (>= 17.3.5)
- Umbraco.Cms.Core (>= 17.3.5)
- Umbraco.Cms.Web.Common (>= 17.3.5)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Translation dashboard with Omni information; selected Dictionary item and descendant scope; target-language selection and preview; placeholder validation; downloadable JSON reports; improved saved-value counts and cancellation handling. Remains free and open source for Umbraco 17.