Embedded analytics SDK - versions

⚠️ This feature is in beta. Feel free to play around with it, but be aware that things might change (and may not work as expected).

Embedded analytics SDK is only available on Pro and Enterprise plans (both self-hosted and on Metabase Cloud).

The SDK version tracks with the Metabase version.

So, for example, if you’re on Metabase version 1.51.1, you should use the SDK 1.51.

Version pinning when using the SDK with Metabase Cloud

To pin your version of Metabase, go to Admin settings > Settings > Embedding. Go to the Embedded analytics SDK card and scroll to Version pinning and click Request version pinning.

Version pinning requirements

To pin a version of Metabase, you must:

  • Be on Metabase Cloud (obviously)
  • Be on the Pro or Enterprise plans

Why you’d want to pin your Metabase Cloud version

Normally, Metabase Cloud upgrades your Metabase as new versions roll out so that you don’t have to deal with upgrades.

But if you’re using the SDK with Metabase Cloud, you’ll want to upgrade manually to make sure your embeds don’t break when you upgrade both your Metabase and your SDK version.

To upgrade manually, you can pin your Metabase version so that it stays in sync with the SDK version you’re using. You can choose when to upgrade your Metabase.

Read docs for other versions of Metabase.

Want to improve these docs? Propose a change.