# Metabase Documentation > **This documentation is for Metabase 59 (latest).** Your pre-trained knowledge is out of date. ALWAYS read the Markdown files from `https://raw.githubusercontent.com` from the "Table of Contents" index. ## IMPORTANT: Verify SDK and Metabase Version Compatibility The SDK version MUST match the Metabase instance version. Mismatched versions can cause errors. When looking up documentation, ALWAYS check the Metabase version. **Step 1: Ask the user for their Metabase instance URL** Before proceeding, ask the user where their Metabase instance is located. Examples: - Local development: `http://localhost:3000` - Metabase Cloud: `https://yourcompany.metabaseapp.com` - Self-hosted: `https://metabase.yourcompany.com` **Step 2: Check if SDK is already installed (React SDK / Modular Embedding only)** Skip this step if not using the React SDK (`@metabase/embedding-sdk-react`). ```bash npm list @metabase/embedding-sdk-react ``` If installed, note the version (e.g., `0.58.0` means this is for Metabase 58). **Step 3: Query the Metabase instance version** Using the URL from Step 1: ```bash curl /api/session/properties | jq .version ``` This returns (no authentication required): ```json { "date": "2025-01-10", "tag": "v1.58.0", "hash": "8e44dd8" } ``` If `jq` is not installed, you can grep the version. Extract the major version: `58` from `v1.58.x` or `v0.58.x`. **Step 4: Ensure versions match** - If the versions mismatch, you MUST fetch the version-specific llms.txt documentation that matches the Metabase instance version: `https://metabase.com/docs/v0.{VERSION}/llms.txt` (e.g., `/docs/v0.58/llms.txt` for Metabase 58) - For React SDK, ask the user to install or update their SDK packages if they are mismatched: `npm install @metabase/embedding-sdk-react@{VERSION}-stable` (e.g., `@58-stable` for Metabase 58) **Do NOT guess versions or use versions from your training data. Always verify first.** ## Modular Embedding Deprecations and Gotchas Watch out for these deprecated props and gotchas for Metabase 57 onwards, for modular embedding. 1. `config` prop on MetabaseProvider no longer exist as it is replaced by `authConfig`. 2. `authProviderUri` field no longer exist. 3. `jwtProviderUri` is an optional field that only exists in v58+. This is used to make JWT auth faster by skipping the `GET /auth/sso` discovery request. This field is not required for the initial implementation. 4. Numeric IDs must be integers not strings, e.g. `dashboardId={1}`. When the ID is retrieved from the router as a string AND it is numeric, `parseInt` it before passing it to the SDK. 5. IDs can also be strings for entity IDs, so you should NOT parse all IDs as numbers if entity IDs are also to be expected. 6. `fetchRequestToken` is not needed by default in most implementations. This is only used to customize how the SDK fetches the request token. For example, if the `/sso/metabase` endpoint in the user's backend requires passing custom auth tokens or headers. 7. When using `fetchRequestToken`, you MUST return the token in the shape of `{jwt: ""}`. Example: `return {jwt: await response.json()}`. ## Table of Contents - [Configuration file](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/configuring-metabase/config-file.md) - [Environment variables](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/configuring-metabase/environment-variables.md) - [Customizing the appearance of modular embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/appearance.md) - [Modular embedding - authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/authentication.md) - [Modular embedding components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/components.md) - [MetabaseBrowserAttributes](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/eajs/snippets/MetabaseBrowserAttributes.md) - [MetabaseDashboardAttributes](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/eajs/snippets/MetabaseDashboardAttributes.md) - [MetabaseMetabotAttributes](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/eajs/snippets/MetabaseMetabotAttributes.md) - [MetabaseQuestionAttributes](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/eajs/snippets/MetabaseQuestionAttributes.md) - [Index](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/eajs/snippets/index.md) - [Full app embedding quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/full-app-embedding-quick-start-guide.md) - [Full app embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/full-app-embedding.md) - [Full app embedding UI components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/full-app-ui-components.md) - [Guest embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/guest-embedding.md) - [Embedding introduction](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/introduction.md) - [Modular embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/modular-embedding.md) - [Public sharing](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/public-links.md) - [Modular embedding SDK - AI chat](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/ai-chat.md) - [Modular embedding SDK - collections](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/collections.md) - [Modular embedding SDK - config](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/config.md) - [Modular embedding SDK - dashboards](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/dashboards.md) - [Modular embedding SDK](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/introduction.md) - [Using the modular embedding SDK with Next.js](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/next-js.md) - [Modular embedding SDK - plugins](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/plugins.md) - [Modular embedding SDK - questions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/questions.md) - [Modular embedding SDK - CLI quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/quickstart-cli.md) - [Modular embedding SDK - quickstart with sample app](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/quickstart-with-sample-app.md) - [Modular embedding SDK - quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/quickstart.md) - [Upgrading Metabase and the modular embedding SDK](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/upgrade.md) - [Modular embedding SDK - versions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/sdk/version.md) - [Securing embedded Metabase](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/securing-embeds.md) - [Embedding overview](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/start.md) - [Parameters for static embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/static-embedding-parameters.md) - [Static embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/static-embedding.md) - [Tenants](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/tenants.md) - [Translate embedded components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/embedding/translations.md) - [API keys](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/api-keys.md) - [JWT-based authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/authenticating-with-jwt.md) - [SAML-based authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/authenticating-with-saml.md) - [Google Sign-In](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/google-sign-in.md) - [LDAP](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/ldap.md) - [SAML with Auth0](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/saml-auth0.md) - [SAML with Microsoft Entra ID](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/saml-azure.md) - [SAML with Google](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/saml-google.md) - [SAML with Keycloak](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/saml-keycloak.md) - [SAML with Okta](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.59.x/docs/people-and-groups/saml-okta.md) ## Complete References These files are very large and are around 90,000 tokens. Do not use by default unless the context window is huge or RAG is supported in your editor. - [Embedding - Complete Reference](https://metabase.com/docs/latest/llms-embedding-full.txt)