Multi-Language Capability Guide

`multi_language` is a product-level capability layered on top of the shared localization infrastructure.

1 min read

multi_language is a product-level capability layered on top of the shared localization infrastructure.

What it enables

When enabled, Tov+ allows:

  • multiple active locale variants per occasion
  • actor language preference to influence guest-facing locale resolution
  • planner access to localized occasion and event authoring
  • planner access to actor language-preference editing
  • guest rendering that prefers localized content when it exists

What still works without it

Without multi_language, Tov+ still has localization infrastructure, but product behavior stays in single-default-locale mode:

  • the occasion default locale still exists
  • guest experiences still render safely in the default locale
  • planner and guest flows still work without localization errors
  • advanced multilingual authoring and actor preference controls stay unavailable

Relation to localization infrastructure

The shared localization capability continues to provide:

  • locale normalization
  • locale fallback helpers
  • localized content storage seams

The multi_language capability decides whether the product is allowed to use those mechanics for richer multilingual behavior.

Occasion and actor behavior

  • enabled: occasion localized content, event localized content, and actor language preference are all active inputs to rendering
  • disabled: occasion default locale wins, actor preference is ignored, and localized authoring is hidden

Planner and guest behavior

  • planner settings show the localization workspace only when multi_language is enabled
  • guest experiences resolve locale using actor preference only when multi_language is enabled
  • guest experiences fall back cleanly to the occasion default locale when the capability is absent

Fallback behavior

Fallback remains deterministic:

  • capability enabled: requested locale -> actor preference -> occasion default -> system default
  • capability disabled: occasion default -> system default