---
title: "Interface MetabaseProviderProps"
url: "https://www.metabase.com/docs/latest/embedding/sdk/api/MetabaseProviderProps"
version: "65"
---

> For the complete documentation index, see [llms.txt](https://www.metabase.com/docs/llms.txt).

# Interface MetabaseProviderProps

**`Expand`**

## Properties

| Property                                                                | Type                                                                                                                                                                         | Description                                                                                                                                                                                                                                                                                            |
| :---------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowConsoleLog?`                         | `boolean`                                                                                                                                                                    | Whether to allow logging to the DevTools console. Defaults to true.                                                                                                                                                                                                                                    |
| `allowedCustomVisualizations?` | `` `custom:${string}` ``[]                                                                                                                                                   | Opt-in support for EE custom visualization plugins inside the SDK. 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. |
| `authConfig`                                    | [`MetabaseAuthConfig`](https://www.metabase.com/docs/latest/embedding/sdk/api/MetabaseAuthConfig.md)                                                                                                                          | Defines how to authenticate with Metabase.                                                                                                                                                                                                                                                             |
| `children`                                        | [`ReactNode`](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/0b728411cd1dfb4bd26992bb35a73cf8edaa22e7/types/react/index.d.ts#L478)                                  | The children of the MetabaseProvider component.                                                                                                                                                                                                                                                        |
| ~~`className?`~~                                 | `string`                                                                                                                                                                     | A custom class name to be added to the root element. **Deprecated** This prop is not used anymore.                                                                                                                                                                                                     |
| `errorComponent?`                           | [`SdkErrorComponent`](https://www.metabase.com/docs/latest/embedding/sdk/api/SdkErrorComponent.md)                                                                                                                            | A custom error component to display when the SDK encounters an error.                                                                                                                                                                                                                                  |
| `eventHandlers?`                             | [`SdkEventHandlersConfig`](https://www.metabase.com/docs/latest/embedding/sdk/api/SdkEventHandlersConfig.md)                                                                                                                  | See [Handle embed events](https://www.metabase.com/docs/latest/embedding/config.md#handle-embed-events-react-sdk-only).                                                                                                                                                                                   |
| `loaderComponent?`                         | [`ComponentType`](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/0b728411cd1dfb4bd26992bb35a73cf8edaa22e7/types/react/index.d.ts#L104)\<\{ `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.                                                                                                                                          |
| `locale?`                                           | `string`                                                                                                                                                                     | Defines the display language. Accepts an ISO language code such as `en` or `de`. Defaults to the instance locale.                                                                                                                                                                                      |
| `pluginsConfig?`                             | [`MetabaseGlobalPluginsConfig`](https://www.metabase.com/docs/latest/embedding/sdk/api/MetabaseGlobalPluginsConfig.md)                                                                                                        | See [Plugins](https://www.metabase.com/docs/latest/embedding/sdk/plugins.md).                                                                                                                                                                                                                             |
| `theme?`                                             | [`MetabaseEmbeddingTheme`](https://www.metabase.com/docs/latest/embedding/sdk/api/MetabaseEmbeddingTheme.md)                                                                                                                  | See [Appearance](https://www.metabase.com/docs/latest/embedding/sdk/appearance).                                                                                                                                                                                                                       |
| `useLegacyMonolithicBundle?`     | `boolean`                                                                                                                                                                    | Whether 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).                                                            |
