OptionalallowConsoleLog?: booleanWhether to allow logging to the DevTools console. Defaults to true.
OptionalallowedCustomVisualizations?: `custom:${string}`[]Opt-in support for EE custom visualization plugins inside the SDK.
When set, the SDK loads custom-viz bundles into an about:blank
sandbox (no hosted-sandbox endpoint required).
Pass an allowlist of custom:-prefixed plugin identifiers (manifest
name), e.g. ["custom:Thumbs", "custom:Calendar"]. Only
listed plugins are loaded. Omit or pass [] to disable.
Requires the custom-viz premium feature.
Defines how to authenticate with Metabase.
The children of the MetabaseProvider component.
OptionalclassName?: stringA custom class name to be added to the root element.
OptionalerrorComponent?: SdkErrorComponentA custom error component to display when the SDK encounters an error.
OptionaleventHandlers?: SdkEventHandlersConfigOptionalloaderComponent?: ComponentType<{ label?: string }>A custom loader component to display while the SDK is loading.
The component receives an optional label prop that can be used to display a loading message.
Optionallocale?: stringDefines the display language. Accepts an ISO language code such as en or de.
Defaults to the instance locale.
OptionalpluginsConfig?: MetabaseGlobalPluginsConfigSee Plugins.
Optionaltheme?: MetabaseEmbeddingThemeSee Appearance.
OptionaluseLegacyMonolithicBundle?: booleanWhether to load the full SDK bundle directly as a single file (legacy behavior), instead of the optimized bootstrap that loads chunks in parallel and starts authentication early.
Defaults to false (uses the optimized bootstrap loader).
A component that provides the Metabase SDK context and theme.