Diplo.Translator 17.1.0

dotnet add package Diplo.Translator --version 17.1.0
                    
NuGet\Install-Package Diplo.Translator -Version 17.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Diplo.Translator" Version="17.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Diplo.Translator" Version="17.1.0" />
                    
Directory.Packages.props
<PackageReference Include="Diplo.Translator" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Diplo.Translator --version 17.1.0
                    
#r "nuget: Diplo.Translator, 17.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Diplo.Translator@17.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Diplo.Translator&version=17.1.0
                    
Install as a Cake Addin
#tool nuget:?package=Diplo.Translator&version=17.1.0
                    
Install as a Cake Tool

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.

Translate dictionary modal

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

Translation progress modal

Completion Summary

Translation completed notification

Refreshed Dictionary Overview

Dictionary overview after translation

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.

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
17.1.0 89 11/9/2026
17.0.0 245 5/7/2026
10.0.1 1,246 11/28/2022
10.0.0 729 7/6/2022

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.