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
plan callouts (#68014)
Alex Yarosh3315a9a65a4d
diff --git a/docs/embedding/appearance.md b/docs/embedding/appearance.mdindex 486a0de2f76..c6d5540031b 100644--- a/docs/embedding/appearance.md+++ b/docs/embedding/appearance.md@@ -7,37 +7,87 @@ redirect_from:# Customizing the appearance of modular embeds-{% include plans-blockquote.html feature="Modular embedding" %}-You can style your embedded [Metabase components](./components.md) with a **theme**.-Change the colors, and the code snippet will include a `theme` object in the object passed to the `defineMetabaseConfig` function.+Guest embeds on OSS/Starter plans come with two theme presets - light and dark. On Metabase Pro/Enterprise plans, you can customize individual colors, fonts, etc.++## Basic theming++You can choose light or dark theme for your embeds. On Pro/Enterprise plans, you can also configure granular appearance settings like background, fonts etc, see [Advanced theming](#advanced-theming).++To add a light or dark theme, pass a `theme` parameter with `preset` to the `defineMetabaseConfig()` function in your [embedding code snippet](./modular-embedding.md#add-the-embedding-script-to-your-app). For example, to specify a dark theme:++```js+defineMetabaseConfig({+ theme: {+ preset: "dark",+ },+ instanceUrl: "http://localhost:3000",+});+```++## Advanced theming++{% include plans-blockquote.html feature="Advanced theming modular embeds" is_plural=true %}++On Pro/Enterprise plan, you can configure granular appearance options, like background colors, font sizes etc. See the [list of all theming options]().++### Add an advanced theme to your embed++++Some appearance options like brand, text, and background color are configurable in in the [embed wizard](./modular-embedding.md#create-a-new-embed).++For other appearance settings, use the `theme` parameter with `preset` in the `defineMetabaseConfig()` function in your [embedding code snippet](./modular-embedding.md#add-the-embedding-script-to-your-app). For example:++```js+defineMetabaseConfig({+ theme: {+ colors: {+ background: "#FFFFFF",+ "text-primary": "hsla(204, 66%, 8%, 0.84)",+ brand: "hsla(208, 72%, 60%, 1.00)",+ "background-hover": "rgb(236, 236, 236)",+ "background-disabled": "rgb(231, 231, 231)",+ "background-secondary": "rgb(233, 233, 233)",+ "background-light": "rgb(233, 233, 233)",+ "text-secondary": "rgba(9, 30, 44, 0.84)",+ "text-tertiary": "rgba(11, 37, 54, 0.84)",+ "brand-hover": "rgb(185, 216, 244)",+ "brand-hover-light": "rgb(238, 245, 252)",+ },+ },+ instanceUrl: "http://localhost:3000",+});+```-## Theme options+### Theme options-Here's an example that includes the various styling options available via the [modular embedding React SDK](./sdk/introduction.md):+{% include plans-blockquote.html feature="Advanced theme options" is_plural=true %}++For advanced theme configuration options, you can configure the `theme` object in the object passed to the `defineMetabaseConfig` function, see [Add an advanced theme to your embed](#add-an-advanced-theme-to-your-embed). Here's the list of all options available for customization:```json{// Specify a font to use from the set of fonts supported by Metabase.// You can set the font to "Custom" to use the custom font// configured in your Metabase instance.- fontFamily: "Lato",+ "fontFamily": "Lato",// Override the base font size for every component.// This does not usually need to be set, as the components// inherit the font size from the parent container, such as the body.- fontSize: "16px",+ "fontSize": "16px",// Override the base line height for every component.- lineHeight: 1.5,+ "lineHeight": 1.5,// Match your application's color scheme- colors: {+ "colors": {// The primary color of your application- brand: "#9B5966",+ "brand": "#9B5966",// Lighter variation of the brand color. Used for hover and accented elements."brand-hover": "#DDECFA",@@ -55,7 +105,7 @@ Here's an example that includes the various styling options available via the [m"text-tertiary": "#949AAB",// Default background color- background: "#FFFFFF",+ "background": "#FFFFFF",// Light background color for some control backgrounds.// Defaults are derived from `background` (slightly darker in light mode, much lighter in dark mode).@@ -71,246 +121,157 @@ Here's an example that includes the various styling options available via the [m"background-disabled": "#F3F5F7",// Color used for borders- border: "#EEECEC",+ "border": "#EEECEC",// Color used for filters context- filter: "#7172AD",+ "filter": "#7172AD",// Color used for aggregations and breakouts context- summarize: "#88BF4D",+ "summarize": "#88BF4D",// Color used to indicate successful actions and positive values/trends- positive: "#BADC58",+ "positive": "#BADC58",// Color used to indicate dangerous actions and negative values/trends- negative: "#FF7979",+ "negative": "#FF7979",/** Color used to outline elements in focus */- focus: "#CAE1F7",+ "focus": "#CAE1F7",/** Color used for popover shadows */- shadow: "rgba(0,0,0,0.08)",+ "shadow": "rgba(0,0,0,0.08)",// Overrides the chart colors. Supports up to 8 colors// Limitation: this does not affect charts with custom series color- charts: [+ "charts": [// can either be a hex code"#9B59B6",// or a color object. tint and shade represents lighter and darker variations// only base color is required, while tint and shade are optional- { base: "#E74C3C", tint: "#EE6B56", shade: "#CB4436" },- ],+ { "base": "#E74C3C", "tint": "#EE6B56", "shade": "#CB4436" }+ ]},- components: {+ "components": {// Dashboard- dashboard: {+ "dashboard": {// Background color for all dashboards- backgroundColor: "#2F3640",+ "backgroundColor": "#2F3640",// Border color of the dashboard grid, shown only when editing dashboards.// Defaults to `colors.border`- gridBorderColor: "#EEECEC",+ "gridBorderColor": "#EEECEC",- card: {+ "card": {// Background color for all dashboard cards- backgroundColor: "#2D2D30",+ "backgroundColor": "#2D2D30",// Apply a border color instead of shadow for dashboard cards.// Unset by default.- border: "1px solid #EEECEC",- },+ "border": "1px solid #EEECEC"+ }},// Question- question: {+ "question": {// Background color for all questions- backgroundColor: "#2E353B",+ "backgroundColor": "#2E353B",// Toolbar of the default interactive question layout- toolbar: {- backgroundColor: "#F3F5F7",- },+ "toolbar": {+ "backgroundColor": "#F3F5F7"+ }},// Tooltips- tooltip: {+ "tooltip": {// Tooltip text color.- textColor: "#FFFFFF",+ "textColor": "#FFFFFF",// Secondary text color shown in the tooltip, e.g. for tooltip headers and percentage changes.- secondaryTextColor: "#949AAB",+ "secondaryTextColor": "#949AAB",// Tooltip background color.- backgroundColor: "#2E353B",+ "backgroundColor": "#2E353B",// Tooltip background color for focused rows.- focusedBackgroundColor: "#0A0E10",+ "focusedBackgroundColor": "#0A0E10"},// Data table- table: {- cell: {+ "table": {+ "cell": {// Text color of cells, defaults to `text-primary`- textColor: "#4C5773",+ "textColor": "#4C5773",// Default background color of cells, defaults to `background`- backgroundColor: "#FFFFFF",+ "backgroundColor": "#FFFFFF",// Font size of cell values, defaults to ~12.5px- fontSize: "12.5px",+ "fontSize": "12.5px"},- idColumn: {+ "idColumn": {// Text color of ID column, defaults to `brand`- textColor: "#9B5966",+ "textColor": "#9B5966",// Background color of ID column, defaults to a lighter shade of `brand`- backgroundColor: "#F5E9EB",- },+ "backgroundColor": "#F5E9EB"+ }},// Number chart- number: {+ "number": {// Value displayed on number charts.// This also applies to the primary value in trend charts.- value: {- fontSize: "24px",- lineHeight: "21px",- },+ "value": {+ "fontSize": "24px",+ "lineHeight": "21px"+ }},// Cartesian chart- cartesian: {+ "cartesian": {// Padding around the cartesian charts.// Uses CSS's `padding` property format.- padding: "4px 8px",+ "padding": "4px 8px"},// Pivot table- pivotTable: {- cell: {+ "pivotTable": {+ "cell": {// Font size of cell values, defaults to ~12px- fontSize: "12px",+ "fontSize": "12px"},// Pivot row toggle to expand or collapse row- rowToggle: {- textColor: "#FFFFFF",- backgroundColor: "#95A5A6",- },+ "rowToggle": {+ "textColor": "#FFFFFF",+ "backgroundColor": "#95A5A6"+ }},- collectionBrowser: {- breadcrumbs: {- expandButton: {- textColor: "#8118F4",- backgroundColor: "#767D7C",- hoverTextColor: "#CE8C8C",- hoverBackgroundColor: "#69264B",- },- },+ "collectionBrowser": {+ "breadcrumbs": {+ "expandButton": {+ "textColor": "#8118F4",+ "backgroundColor": "#767D7C",+ "hoverTextColor": "#CE8C8C",+ "hoverBackgroundColor": "#69264B"+ }+ }},// Popover are used in components such as click actions in interactive questions.- popover: {+ "popover": {// z-index of the popover. Useful for embedding components in a modal. defaults to 4.- zIndex: 4,- },- },+ "zIndex": 4+ }+ }}```--## Customizing the appearance of an SSO embed----Add a `theme` object to your config object:---```html-<script defer src="http://localhost:3000/app/embed.js"></script>-<script>-function defineMetabaseConfig(config) {- window.metabaseConfig = config;-}-</script>--<script>- defineMetabaseConfig({- "theme": {- "colors": {- "background": "#FFFFFF",- "text-primary": "hsla(204, 66%, 8%, 0.84)",- "brand": "hsla(208, 72%, 60%, 1.00)",- "background-hover": "rgb(236, 236, 236)",- "background-disabled": "rgb(231, 231, 231)",- "background-secondary": "rgb(233, 233, 233)",- "background-light": "rgb(233, 233, 233)",- "text-secondary": "rgba(9, 30, 44, 0.84)",- "text-tertiary": "rgba(11, 37, 54, 0.84)",- "brand-hover": "rgb(185, 216, 244)",- "brand-hover-light": "rgb(238, 245, 252)"- }- },- "instanceUrl": "http://localhost:3000"- });-</script>--<metabase-dashboard dashboard-id="10"- with-title="true"- with-downloads="false"- with-subscriptions="false"- hidden-parameters='["category"]'- drills="true">-</metabase-dashboard>-```--## Customizing the appearance of a guest embed----Add a `theme` object to your config object:--```html-<script defer src="http://localhost:3000/app/embed.js"></script>-<script>-function defineMetabaseConfig(config) {- window.metabaseConfig = config;-}-</script>--<script>- defineMetabaseConfig({- "theme": {- "colors": {- "background": "#FFFFFF",- "text-primary": "hsla(204, 66%, 8%, 0.84)",- "brand": "hsla(208, 72%, 60%, 1.00)",- "background-hover": "rgb(236, 236, 236)",- "background-disabled": "rgb(231, 231, 231)",- "background-secondary": "rgb(233, 233, 233)",- "background-light": "rgb(233, 233, 233)",- "text-secondary": "rgba(9, 30, 44, 0.84)",- "text-tertiary": "rgba(11, 37, 54, 0.84)",- "brand-hover": "rgb(185, 216, 244)",- "brand-hover-light": "rgb(238, 245, 252)"- }- },- "isGuest": true,- "instanceUrl": "http://localhost:3000"- });-</script>--<metabase-dashboard- token=<TODO: Fetch the JWT token from your backend and programmatically pass it to this 'metabase-dashboard' component>- with-title="true"- with-downloads="false">-</metabase-dashboard>-```-## Example app with themingCheck out our [sample app](https://github.com/metabase/modular-embedding-sample-app). Bring your Metabase, embed a question or dashboard, and play around with changing colors.diff --git a/docs/embedding/authentication.md b/docs/embedding/authentication.mdindex a2d63d1ad7b..a4882947d1c 100644--- a/docs/embedding/authentication.md+++ b/docs/embedding/authentication.md@@ -2,12 +2,12 @@title: Modular embedding - authenticationsummary: Adding SSO with JWT or SAML for authenticating modular embeds.redirect_from:-- /docs/latest/embedding/sdk/authentication+ - /docs/latest/embedding/sdk/authentication---# Modular embedding - authentication-{% include plans-blockquote.html feature="Modular embedding" sdk=true %}+{% include plans-blockquote.html feature="Authenticated embeds" sdk=true is_plural=true%}For using modular embedding with SSO in production, you'll need to set up authentication.diff --git a/docs/embedding/components.md b/docs/embedding/components.mdindex f5ad90727fd..5faf461c9da 100644--- a/docs/embedding/components.md+++ b/docs/embedding/components.md@@ -27,7 +27,10 @@ To render a dashboard:### Optional parameters- `with-title` (default is true) - show the dashboard title in the embed-- `with-downloads` (default is false) - show the button to download the dashboard as PDF and download question results++{% include plans-blockquote.html feature="More parameters for dashboard component" convert_pro_link_to_embbedding=true is_plural=true%}++- `with-downloads` (default is true on OSS/Starter and false on Pro/Enterprise) - show the button to download the dashboard as PDF and download question results- `drills` (default is true) - lets you drill through the dashboard- `initial-parameters` - default value for dashboard filters, like `{ 'productId': '42' }`.- `with-subscriptions` - let people set up [dashboard subscriptions](../dashboards/subscriptions.md). Unlike subscriptions sent from non-embedded dashboards, subscriptions sent from embedded dashboards exclude links to Metabase items, as Metabase assumes the recipient lacks access to the embedded Metabase.@@ -35,6 +38,8 @@ To render a dashboard:- `hidden-parameters` - list of filter names to hide from the dashboard, like `['productId']`- `locale` - see [translations](./translations.md) (only available for guest embeds).+Only `with-title` and `with-downloads` are supported in [guest embeds](./guest-embedding.md).+If you surround your attribute value with double quotes, make sure to use single quotes:```html@@ -73,22 +78,32 @@ To render a question (chart):### Optional parameters-- `drills` (default is true) - lets you drill through the question- `with-title` (default is true) - show the title-- `with-downloads` (default is false) - show downloads++{% include plans-blockquote.html feature="More parameters for dashboard component" convert_pro_link_to_embbedding=true is_plural=true%}++- `drills` (default is true) - lets you drill through the question+- `with-downloads` (default is true on OSS/Starter and false on Pro/Enterprise) - show downloads- `initial-sql-parameters` - default value for SQL parameters, only applicable to native SQL questions, like `{ "productId": "42" }`- `is-save-enabled` (default is false)- `target-collection` - this is to enforce saving into a particular collection. Values: regular ID, entity ID, `"personal”`, `"root”`+Only `with-title` and `with-downloads` are supported in [guest embeds](./guest-embedding.md).+## Browser+{% include plans-blockquote.html feature="Browser component" convert_pro_link_to_embbedding=true%}++Browser component is only available for authenticated modular embeds. It's unavailable for [Guest embeds](./guest-embedding.md).+To render a collection browser so people can navigate a collection and open dashboards or questions:```html<metabase-browserinitial-collection="14"read-only="false"- collection-entity-types="['collection', 'dashboard']">+ collection-entity-types="['collection', 'dashboard']"+></metabase-browser>```@@ -108,6 +123,10 @@ To render a collection browser so people can navigate a collection and open dash## AI chat+{% include plans-blockquote.html feature="AI chat component" convert_pro_link_to_embbedding=true%}++AI chat component is only available for authenticated modular embeds. It's unavailable for [Guest embeds](./guest-embedding.md).+To render the AI chat interface:```html@@ -127,6 +146,8 @@ None.## Customizing loader and error components+{% include plans-blockquote.html feature="Customizing loader and error componentst" convert_pro_link_to_embbedding=true%}+If you're using the [modular embedding SDK](./sdk/introduction.md), you can provide your own components for loading and error states by specifying `loaderComponent` and `errorComponent` as props to `MetabaseProvider`.```tsxdiff --git a/docs/embedding/full-app-embedding-quick-start-guide.md b/docs/embedding/full-app-embedding-quick-start-guide.mdindex 165ff3c8ee5..198f316f238 100644--- a/docs/embedding/full-app-embedding-quick-start-guide.md+++ b/docs/embedding/full-app-embedding-quick-start-guide.md@@ -16,6 +16,8 @@ You'll embed the full Metabase application in your app. Once logged in, people c## Prerequisites+{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embbedding=true%}+- You have an app that you can embed Metabase in.- You have a Pro or Enterprise subscription of Metabase. If you're unsure where to start, sign up for a free trial for [Pro On-Prem](https://store.metabase.com/checkout/embedding). If you have Docker Desktop installed, you can just search for "metabase-enterprise" to find the Docker image and run it. Alternatively, you can follow [these instructions](../installation-and-operation/running-metabase-on-docker.md#pro-or-enterprise-quick-start).diff --git a/docs/embedding/full-app-ui-components.md b/docs/embedding/full-app-ui-components.mdindex 1e5b69d0317..120e35be7f9 100644--- a/docs/embedding/full-app-ui-components.md+++ b/docs/embedding/full-app-ui-components.md@@ -7,6 +7,8 @@ redirect_from:# Full app embedding UI components+{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embbedding=true%}+To change the interface of your full app 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).> For more granular control of embedded components, consider using [Modular embedding](./modular-embedding.md) instead of full app embedding - it's an improved, more customizable option for embedding Metabase elements.diff --git a/docs/embedding/guest-embedding.md b/docs/embedding/guest-embedding.mdindex 86a363e0b3b..10e8d6e9c4e 100644--- a/docs/embedding/guest-embedding.md+++ b/docs/embedding/guest-embedding.md@@ -37,7 +37,7 @@ To create a guest embed:## Notes on the code the wizard generates-You can edit the code (see [components](./components.md) and [appearance](./appearance.md). But here's an overview of the code the wizard generates, and where to put it.+You can edit the code (see [components](./components.md) and [appearance](./appearance.md)). But here's an overview of the code the wizard generates, and where to put it.### Client-side code@@ -91,6 +91,7 @@ const token = jwt.sign(payload, METABASE_SECRET_KEY);Replace `YOUR_METABASE_SECRET_KEY` with your [embedding secret key](#regenerating-the-embedding-secret-key).### Component attributes+You can set different attributes to enable/disable UI. Here are some example attributes:| Attribute | Description |@@ -102,6 +103,10 @@ You can set different attributes to enable/disable UI. Here are some example attAttributes will differ based on the type of thing you're embedding. Guest embeds have fewer options that embeds that use SSO. See more on [components and their attributes](./components.md).+### Customizing appearance of guest embeds++Appearance settings available for guest embeds depend on your Metabase plan. If you're running Metabase OSS/Starter, you can select light or dark theme. If you're running Metabase Pro/Enterprise, you'll have access to granular customization options, see [Appearance](./appearance.md)+## Editing parameters on an embedded question or dashboardIf you change the [parameters](./static-embedding-parameters.md) of your embedded item:diff --git a/docs/embedding/modular-embedding.md b/docs/embedding/modular-embedding.mdindex ebda41b543a..44aba9a8073 100644--- a/docs/embedding/modular-embedding.md+++ b/docs/embedding/modular-embedding.md@@ -7,8 +7,6 @@ redirect_from:# Modular embedding-{% include plans-blockquote.html feature="Modular embedding with SSO" convert_pro_link_to_embbedding=true %}-{% include shared/in-page-promo-embedding-workshop.html %}@@ -26,6 +24,10 @@ If you're using React, check out the [Modular embedding SDK](./sdk/introduction.## Create a new embed+You can generate a code snippet for embedding a component by going through the embed wizard.++### 1. Open the embed wizard+In your Metabase:1. Visit the item you want to embed.@@ -40,25 +42,21 @@ You can also go to **Admin settings > Embedding > Modular embedding** and click-## Pick how to authenticate the embed+### 2. Pick how to authenticate the embed++{% include plans-blockquote.html feature="Authenticated modular embedding" convert_pro_link_to_embbedding=true %}How you authenticate the embed determines how cool the embed can get. This page covers the SSO setup, which lets you do everything. This setup requires you to have [set up SSO for your Metabase](./authentication.md). You can check out a [comparison between SSO and guest](./introduction.md#comparison-of-embedding-types), or jump straight to the [guest embed docs](./guest-embedding.md). But we recommend setting up modular embedding with SSO.-## Customize your embed+### 3. Customize your embed-The exact customization options you see will depend on what type of entity you're embedding. You'll see a live preview of the embed with your customizations.+The exact customization options you see will depend on what type of entity you're embedding and which [Metabase plan](https://www.metabase.com/plans) you're on. You'll see a live preview of the embed with your customizations.-You'll also be able to pick colors for:--- Brand-- Text-- Background--But you can customize a lot more later. To configure other colors (like secondary colors, query builder colors, and more), as well as font, you can specify a `theme` in your embed code snippet.+If you are on Metabase OSS/Starter plans, you'll be able to select light or dark themes for your components. On Metabase Pro/Enterprise, you'll be also be able to pick specific colors for brand, text, and background in the embed wizard, and add more customization options through [appearance settings](./appearance.md) later.-All the customization options you select in this interactive flow will be reflected in code snippet, which you can edit as you see fit.+All the customization options you select in this wizard will be reflected in code snippet that the embed wizard will generate for you, and you'll be able to add more options later.For example, this code defines the font, color, and size for text, background colors, and colors for filters and summaries:@@ -87,7 +85,7 @@ Once you're done customizing your embed, click **Next**.## Add the embedding script to your app-Metabase will generate a code snippet that you can copy and paste into your app. See the example below. You can later modify this code snippet to specify additional appearance options or change the behavior of some components.+If you [create an embed through the built-in embed wizard](#create-a-new-embed), Metabase will generate a code snippet that you can copy and paste into your app. See the example below. You can later modify this code snippet to specify additional appearance options or change the behavior of some components.You'll add this code snippet to your app and refresh the page.@@ -105,13 +103,13 @@ Here's an example snippet:<script defer src="https://your-metabase-url/app/embed.js"></script>+<!-- Embedding configuration --><script>function defineMetabaseConfig(config) {window.metabaseConfig = config;}</script>-<!-- Embedding configuration --><script>defineMetabaseConfig({instanceUrl: "https://your-metabase-url",@@ -135,7 +133,9 @@ If you're embedding multiple components in a single page, you only need to inclu## Each end user should have their own Metabase account-With SSO embeds, each end-user must have their own Metabase account.+{% include plans-blockquote.html feature="Modular embedding with SSO" convert_pro_link_to_embbedding=true %}++With SSO embeds, each end-user must have their own Metabase account. If you can't provision accounts for every end user, you have to use [Guest embeds](./guest-embedding.md) instead.The problem with having end-users share a Metabase account is that, even if you filter data on the client side via the modular embedding, all end-users will still have access to the session token, which they could use to access Metabase directly via the API to get data they’re not supposed to see.@@ -145,9 +145,9 @@ In addition to this, we consider shared accounts to be unfair usage. Fair usage## Customizing embeds-The exact customization options you see will depend on what type of entity you're embedding.+The exact customization options you see will depend on what type of entity you're embedding and which plan you're on.-When you're creating a new embed using **Admin > Embedding > Setup guide > Embed in your code**, you'll see the following customization options in the interactive creation flow. These options correspond to parameters in [components](./components.md).+When you're creating a new embed using **Admin > Embedding > Setup guide > Embed in your code**, you'll see some or all the following customization options in the interactive creation flow. These options correspond to parameters in [components](./components.md).- **Allow people to drill through on data points**: determines whether people can interact with the chart (or charts on a dashboard). Interactivity includes [drilling down](https://www.metabase.com/learn/metabase-basics/querying-and-dashboards/questions/drill-through) to individual records from aggregated questions, filtering on click, zooming in, etc. Disabling drill-through for an embedded _question_ also disables people's ability to add filters and summaries.@@ -199,6 +199,8 @@ API keys should only be used for testing with trusted people. Anyone with access## Embedding Metabase in a different domain+{% include plans-blockquote.html feature="Authenticated modular embeds" convert_pro_link_to_embbedding=true is_plural=true %}+If you want to embed Metabase in another domain (say, if Metabase is hosted at `metabase.yourcompany.com`, but you want to embed Metabase at `yourcompany.github.io`), you can tell Metabase to set the session cookie's SameSite value to "none".You can set session cookie's SameSite value in **Admin settings** > **Embedding** > **Security** > **SameSite cookie setting**.@@ -217,8 +219,12 @@ Learn more about [SameSite cookies](https://developer.mozilla.org/en-US/docs/Web## Setting up SSO+{% include plans-blockquote.html feature="Authenticated modular embeds" convert_pro_link_to_embbedding=true is_plural=true %}+For production use, you'll need to set up SSO authentication. See [Modular embedding - authentication](./authentication.md) for details on setting up JWT or SAML authentication.## Example app with SSO embed and theming+{% include plans-blockquote.html feature="Authenticated modular embeds" convert_pro_link_to_embbedding=true is_plural=true %}+Check out our [sample app](https://github.com/metabase/modular-embedding-sample-app). Bring your Metabase, embed a dashboard, and play around with changing colors.diff --git a/docs/embedding/securing-embeds.md b/docs/embedding/securing-embeds.mdindex 1a4a030c72d..8f43768bd11 100644--- a/docs/embedding/securing-embeds.md+++ b/docs/embedding/securing-embeds.md@@ -160,6 +160,8 @@ The flow might look something like this:## Modular and full app embedding auth with JWT or SAML+{% include plans-blockquote.html feature="Authenticated embeds" is_plural=true %}+Modular embedding (including using the [SDK](./sdk/introduction.md)), and [full-app embedding](./full-app-embedding.md) integrate with SSO (either [JWT](../people-and-groups/authenticating-with-jwt.md) or [SAML](../people-and-groups/authenticating-with-saml.md)) to authenticate and authorize people in one flow. The auth integration makes it easy to map user attributes (such as a person's role or department) to granular levels of data access, including:- [Tables](../permissions/data.md)