Documentation

Configuration reference

Review every DiploTranslatorOmni application setting, its default and its purpose.

All settings are optional and live below DiploTranslatorOmni. Out-of-range values are normalised to safe effective values and logged as warnings.

Translation requests

Setting	Default	Purpose
`ChatProfileAlias`	None	Fallback Umbraco.AI chat profile alias.
`TranslationRequestTimeoutSeconds`	60	Timeout for each AI translation request.
`TranslationRetryCount`	2	Retries after the initial request.
`TranslationRetryDelayMilliseconds`	500	Delay between retry attempts.
`MaxConcurrentTranslationRequests`	4	Host-wide request cap, clamped from 1 to 16. Restart required after changing it.

ContentTranslation

Setting	Default	Purpose
`JobHistoryPageSize`	50	Job-history records requested per page.
`MaxSectionPages`	1000	Maximum pages scanned below a section root.
`MaxSelectedPages`	1000	Maximum pages submitted in one section job.
`MaxSelectedPropertiesPerPage`	100	Maximum selected properties submitted for each page.
`PropertyEditorMappings`	Empty	Explicit editor-alias mappings to `PlainText` or `RichText`.

Permissions and glossary

Setting	Default	Purpose
`Glossary:AllowSectionUsersToManage`	true	Allows Translation-section users to manage glossary rules.
`Permissions:AllowSectionUsersToOverwriteExistingValues`	true	Allows Translation-section users to use overwrite and force-selected modes.

DatabaseCleanup

Setting	Default	Purpose
`Enabled`	true	Enables scheduled metadata and job-history cleanup.
`InitialDelayMinutes`	5	Delay before the first cleanup run.
`IntervalHours`	24	Interval between cleanup runs.
`ContentStateRetentionDays`	0	Translation-state retention; zero disables cleanup for this table.
`JobHistoryRetentionDays`	90	Completed job-history retention; zero disables cleanup for this table.
`BatchSize`	1000	Maximum records processed in a cleanup batch.

Cleanup never changes Umbraco content values.

Diagnostics

Setting	Default	Purpose
`Enabled`	false	Enables content-translation diagnostic files.
`IncludeRawValues`	false	Includes potentially sensitive raw persisted values.
`DevelopmentOnly`	true	Restricts diagnostic capture to Development.
`Path`	`App_Data/DiploTranslatorOmni/Diagnostics`	Optional output directory; invalid paths fall back to the default.

Diplo Translator Omni

Ready to translate your first draft?

Bring AI translation into the Umbraco backoffice — and keep the final say with your editors.

View pricing and licensing Read the docs