Getting started

Before you begin

• Umbraco 17 running on .NET 10
• An Umbraco.AI chat provider installed and configured
• At least two languages configured in Umbraco
• An administrator account, or a user group with access to Umbraco's Translation section

Install the package

Add Omni to your Umbraco web project and restart the site:

dotnet add package Diplo.Translator.Omni

The package places its compiled backoffice assets under /App_Plugins/DiploTranslatorOmni/.

Connect an AI provider

Configure at least one Umbraco.AI provider. Our Umbraco.AI configuration guide covers provider installation, profiles, model selection and API keys. Omni uses an approved chat profile selected in Settings → Translator settings, a configured fallback alias, or the host site's default chat profile.

Create your first translated draft

1. Save the source-language version of a document.
2. Open its Translate workspace view or entity action.
3. Choose the source and target languages.
4. Preview the supported properties and select what to translate.
5. Start the job, review the target-language draft and publish it manually when ready.

Omni reads saved values, including saved drafts. Save browser edits before previewing or translating.

Next steps

Continue with installation and configuration for production settings, or learn about the complete translation workflow.