Getting started

This documentation applies to Omni for Umbraco 17 and 18. Both version lines have the same functionality and configuration. Choose the package version for your Umbraco site.

Before you begin

• Umbraco 17.6.1+ or 18.2.0+ running on .NET 10, using the matching Omni version line
• An Umbraco.AI chat provider installed and configured, using the 17.x packages for Umbraco 17 or the 18.x packages for Umbraco 18
• At least two languages configured in Umbraco
• An administrator account, or a user group with access to Umbraco's Translation section

Install the package

Omni supports Umbraco 17 and 18 on .NET 10 through the same NuGet package, Diplo.Translator.Omni. Use the 17.x.x version line for Umbraco 17 or 18.x.x for Umbraco 18. Both have identical functionality and configuration, with the same price, licensing and evaluation terms.

Run the matching command in your Umbraco web project:

Umbraco 17

dotnet add package Diplo.Translator.Omni --version "17.*"

Umbraco 18

dotnet add package Diplo.Translator.Omni --version "18.*"

These commands select the latest stable release within the specified major version. You can also specify an exact release from that version line. Keep Omni on the version line matching your Umbraco major version when updating.

NuGet installs the core Umbraco.AI package automatically as an Omni dependency. Provider integrations are installed separately. Use matching Umbraco.AI and chat provider packages: 17.x for Umbraco 17, or 18.x for Umbraco 18. Rebuild and restart the site after installation. The workflows and settings documented here apply to both Omni version lines.

The current package dependency floors are Umbraco 17.6.1 with Umbraco.AI 17.3.0 for the 17.x line, and Umbraco 18.2.0 with Umbraco.AI 18.3.5 for the 18.x line. Check the selected release's NuGet dependencies when updating; provider packages must also be compatible with that host and AI version.

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

The core Umbraco.AI package is installed automatically with Omni. Provider integrations, account credentials and Chat profiles still need to be configured. The official integration packages are free to install; provider API usage is a separate cost.

Activate your licence

Before starting translation jobs, sign in as an administrator, open Settings → Translator settings and activate your paid or evaluation licence in the licensing panel. The free evaluation allows five accepted single-page draft translation runs on one installation, with no time limit. Previews and read-only dashboards do not consume runs; section jobs, Dictionary translation and replacement of existing values require a paid licence. See licence setup for details.

Connect an AI provider

Install and configure at least one Umbraco.AI Chat provider, or reuse an existing working connection and profile. An administrator can approve multiple profiles and choose the default in Settings → Translator settings; editors can then choose an approved profile per job. 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. Only when no profiles are approved does it use a configured fallback alias or the host site's default Chat profile; an unavailable approved default must be repaired in settings.

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.