Skip to main content
Use the exported StudioLocaleCatalog type. Catalogs belong to your application, so package updates do not overwrite them. The same localization object works with MediaStudio and mountMediaStudio.

Override a few messages

Keep catalog/loader objects stable outside the component or memoize them. The SDK shares successful lazy loads by loader identity; recreating loader functions on every render defeats that reuse.

Add a language as a lazy module

Create translations/de.ts in your application:
Register it in the host bundle:
This is intentionally a partial German catalog: untranslated keys fall back to English. Your bundler owns the lazy module URL; Studio does not build an import path from untrusted locale input. Labels expose registered languages in the language selector. Only relevant language loaders run.

Understand catalog sections

Preserve interpolation tokens exactly. Workspace interpolation uses {name}-style tokens; Laravel uses :name, and plural/count behavior belongs to the specific consumer. Translate surrounding text rather than renaming tokens. Keep labels as strings, not HTML or React elements.

Require a complete catalog in your application

The public API permits partial overrides. To make missing keys a compiler error for your own translation module, declare a stricter type:
Apply satisfies CompleteStudioCatalog to your full dictionary. Use the matching package version’s English catalogs as the key inventory: main packages/react/src/locales/en.ts, workspace packages/react/src/locales/workspace/en.ts and key manifest packages/react/src/studio-locales.ts, and each component namespace’s locales/en.ts. These source files are an authoring reference, not public deep-import paths. The exported types provide the supported validation surface.

Loading, retries and current limits

A loaded dictionary is committed together, keeping the library/chat instance mounted. Optional custom-loader failures fall back to the shipped catalog; a required English catalog failure exposes startup retry behavior. Failed custom loads are evicted from the loader cache and can run again on a subsequent load. The schema covers catalog-backed copy. Some assistant and specialized editor text currently contains direct English/Polish branches, so completing every catalog key does not prove that every visible sentence in every integration has been translated. Check those surfaces when adding a language. Laravel labels and FLEX Fields’ own labels have their own namespaces. See Laravel translations and RTL validation.