Installation & configuration

Install Omni

dotnet add package Diplo.Translator.Omni

Restart the application after installation. Omni registers its Management API, background services, Translation-section dashboards and backoffice assets automatically.

Configure Umbraco.AI

Install and configure an Umbraco.AI chat provider in the host site, then test its chat profile before making it available to translators. Follow the dedicatedUmbraco.AI configuration guide for provider installation, profiles, model selection, API keys and production guidance.

Add package settings

All optional settings live below DiploTranslatorOmni in appsettings.json. A practical starting point is:

{
  "DiploTranslatorOmni": {
    "ChatProfileAlias": "your-chat-profile-alias",
    "TranslationRequestTimeoutSeconds": 60,
    "TranslationRetryCount": 2,
    "TranslationRetryDelayMilliseconds": 500,
    "MaxConcurrentTranslationRequests": 4,
    "ContentTranslation": {
      "MaxSectionPages": 1000,
      "MaxSelectedPages": 1000,
      "MaxSelectedPropertiesPerPage": 100
    },
    "Glossary": { "AllowSectionUsersToManage": true },
    "Permissions": { "AllowSectionUsersToOverwriteExistingValues": true }
  }
}

Remove ChatProfileAlias to let Umbraco.AI resolve its default chat profile when no administrator-managed default is available. Administrator profile settings take precedence over this fallback.

Configure languages and access

Add at least two languages in Umbraco. Grant trusted translator groups access to the built-in Translation section and the normal browse/update permissions required for their content.

Production checklist

• Test translation quality, prompts, token limits and provider guardrails.
• Set concurrency and page limits appropriate for the host and AI provider.
• Decide whether section users may manage glossary rules and overwrite existing translations.
• Keep diagnostics raw-value capture disabled unless explicitly required.
• Review the complete configuration reference.