Skip to content

Document uiOverrides for translating embedded UI - #1196

Merged
magnew merged 4 commits into
mainfrom
mintlify/a0cc38e7
Aug 28, 2026
Merged

Document uiOverrides for translating embedded UI#1196
magnew merged 4 commits into
mainfrom
mintlify/a0cc38e7

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Documents the new uiOverrides React SDK prop that translates Lightdash's UI chrome (filter operators and inputs, the filter popover, date zoom, tile menus, export buttons) in embeds, complementing the existing contentOverrides mechanism.

Changes to embed/react-sdk.mdx:

  • Localization section now opens with a comparison of the two translation props (contentOverrides for your content, uiOverrides for Lightdash's UI) and notes that the host app owns locale state with English fallback for omitted keys.
  • New "Translating the Lightdash UI with uiOverrides" section: typed SdkUiOverrides key set, key namespaces (filters.*, dateZoom.*, tileMenu.*, dashboard.*), rules (optional keys, stable additive contract, {token} placeholders, one-key-per-plural-form limitation), and the i18next integration pattern.
  • Updated "What can be translated" to cover both props plus explicit non-translatable surfaces (warehouse data, dbt field/table names, date picker internals, data formatting, editor-only UI).
  • Added uiOverrides to the Dashboard, DashboardBuilder, Chart, and Explore prop listings, and to the AiAgent/MetricsCatalog "not accepted" notes.

Details verified against DEFAULT_UI_STRINGS and the SDK prop types in lightdash/lightdash. The minimum SDK version was not pinned since it wasn't provided; happy to add it once known.


Generated by Mintlify Agent.

Requested by: marshall@lightdash.com via Slack
Mintlify session: slack_1787904965.300369_C0A3PQ0B2HZ

@mintlify

mintlify Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Aug 28, 2026, 8:23 AM

@github-actions

github-actions Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.

@magnew
magnew merged commit 5f87ebc into main Aug 28, 2026
7 checks passed
@magnew
magnew deleted the mintlify/a0cc38e7 branch August 28, 2026 13:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant