The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
TypeScript analyticsbibusiness-intelligencebusinessintelligenceclojuredashboarddatadata-analysisdata-visualizationdatabasemetabasemysqlpostgrespostgresqlreportingslacksql-editorvisualization
interactive embedding notes (#64007)
Alex Yarosha9e0afd420fd
diff --git a/docs/embedding/interactive-embedding-quick-start-guide.md b/docs/embedding/interactive-embedding-quick-start-guide.mdindex c204cc3991a..6c1a3b4070a 100644--- a/docs/embedding/interactive-embedding-quick-start-guide.md+++ b/docs/embedding/interactive-embedding-quick-start-guide.md@@ -4,6 +4,8 @@ title: "Interactive embedding quickstart"# Interactive embedding quickstart+> If you are just starting out with Metabase embedding, consider using [Embedded Analytics JS](./embedded-analytics-js.md) - an improved, more customizable option for embedding interactive Metabase elements. Interactive embedding remains fully supported.+You'll embed the full Metabase application in your app. Once logged in, people can view a Metabase dashboard in your web app, and be able to use the full Metabase application to explore their data, and only their data.{% include shared/in-page-promo-embedding-workshop.html %}diff --git a/docs/embedding/interactive-embedding.md b/docs/embedding/interactive-embedding.mdindex e86224705b3..f9d5b028214 100644--- a/docs/embedding/interactive-embedding.md+++ b/docs/embedding/interactive-embedding.md@@ -13,6 +13,8 @@ redirect_from:**Interactive embedding** is what you want if you want to offer [multi-tenant, self-service analytics](https://www.metabase.com/learn/metabase-basics/embedding/multi-tenant-self-service-analytics).+> If you are just starting out with Metabase embedding, consider using [Embedded Analytics JS](./embedded-analytics-js.md) instead of interactive embedding - it's an improved, more customizable option for embedding interactive Metabase elements. Interactive embedding remains fully supported.+Interactive embedding is the only type of embedding that integrates with your [permissions](../permissions/introduction.md) and [SSO](../people-and-groups/start.md#authentication) to give people the right level of access to [query](https://www.metabase.com/glossary/query-builder) and [drill-down](https://www.metabase.com/learn/metabase-basics/querying-and-dashboards/questions/drill-through) into your data.## Interactive embedding demodiff --git a/docs/embedding/interactive-ui-components.md b/docs/embedding/interactive-ui-components.mdindex 06fb3cb9f5c..89356094551 100644--- a/docs/embedding/interactive-ui-components.md+++ b/docs/embedding/interactive-ui-components.md@@ -7,6 +7,8 @@ description: Customize the UI components in your interactive Metabase embed by aTo change the interface of your interactive embed, you can add parameters to the end of your embedding URL. If you want to change the colors or fonts in your embed, see [Customizing appearance](../configuring-metabase/appearance.md).+> If you are just starting out with Metabase embedding, consider using [Embedded Analytics JS](./embedded-analytics-js.md) instead of interactive embedding - it's an improved, more customizable option for embedding interactive Metabase elements. Interactive embedding remains fully supported.+For example, you can disable Metabase's [top nav bar](#top_nav) and [side nav menu](#side_nav) like this:```diff --git a/docs/embedding/introduction.md b/docs/embedding/introduction.mdindex b5d8dfc141a..1d4c7c70059 100644--- a/docs/embedding/introduction.md+++ b/docs/embedding/introduction.md@@ -20,15 +20,9 @@ With the [Embedded analytics SDK](./sdk/introduction.md), you can embed individu## Embedded analytics JS-With [Embedded analytics JS](./embedded-analytics-js.md), you can embed individual Metabase components in your web app with JavaScript — no React required. Choose from dashboards, questions, or the query builder, and configure per‑component options like drill‑through, parameters, downloads, and theming.+With [Embedded analytics JS](./embedded-analytics-js.md), you can embed individual Metabase components in your web app with JavaScript — no React required. Choose from dashboards, questions, or the query builder, and configure per‑component options like drill‑through, parameters, downloads, and theming. Embedded Analytics JS integrates with [SSO](securing-embeds.md) and [data permissions](../permissions/embedding.md).-**When to use Embedded analytics JS**: you’re not using React (or want a drop‑in script) and want to embed Metabase components with per‑component controls and theming.--## Interactive embedding--Interactive embedding is the only kind of embedding that [integrates with SSO and data permissions](./interactive-embedding.md) to enable true self-service access to the underlying data.--**When to use interactive embedding**: you want to [offer multi-tenant, self-service analytics](https://www.metabase.com/blog/why-full-app-embedding). With interactive embedding, people can create their own questions, dashboards, models, and more, with row and column security policies determining which data they can access.+**When to use Embedded analytics JS**: You want to [offer multi-tenant, self-service analytics](https://www.metabase.com/blog/why-full-app-embedding), you’re not using React (or want a drop‑in script) and want to embed Metabase components with per‑component controls and theming.## Static embedding@@ -42,6 +36,10 @@ If you'd like to share your data with the good people of the internet, admins ca**When to use public links and embeds**: public links and embeds are good for one-off charts and dashboards. Admins can use them when you just need to show someone a chart or dashboard without giving people access to your Metabase. And you don't care who sees the data; you want to make those stats available to everyone.+## Interactive embedding++[Interactive embedding](./interactive-embedding.md) allows you to embed the entire Metabase app in an iframe, and integrate Metabase SSO with your app's authentication.+## Comparison of embedding types| Action | [SDK](./sdk/introduction.md) | [JS](./embedded-analytics-js.md) | [Interactive](./interactive-embedding.md) | [Static](./static-embedding.md) | [Public](../embedding/public-links.md) |@@ -64,9 +62,9 @@ If you'd like to share your data with the good people of the internet, admins caWhen deciding between the Embedded analytics SDK and Embedded analytics JS: if your app uses React, you should use the SDK. Otherwise, use the JS library. The JS library uses the SDK under the hood, but you can have more control with React and the SDK.-## Switching from static to interactive embedding+## Switching from static embedding to Embedded Analytics JS-[Interactive embedding](./interactive-embedding.md) requires authentication via single sign-on (SSO), so you'll need to set that up both in your Metabase and in your application's server. Check out our [Interactive embedding quick start](../embedding/interactive-embedding-quick-start-guide.md).+[Embedded Analytics JS](./embedded-analytics-js.md) requires authentication via single sign-on (SSO), so you'll need to set that up both in your Metabase and in your application's server. Check out our [Modular embedding authentication](../embedding/sdk/authentication.md).## Further reading