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
docs - custom viz embedding web components (#79403)
Jeff Bruemmer16d281da2a43
diff --git a/docs/README.md b/docs/README.mdindex ffda962551c..759195c2df6 100644--- a/docs/README.md+++ b/docs/README.md@@ -223,6 +223,7 @@ Metabase's reference documentation.- [SSO](./embedding/modular-embedding.md)- [Guest](./embedding/guest-embedding.md)- [SDK](./embedding/sdk/introduction.md)+ - [Custom visualizations](./embedding/custom-visualizations.md)- [Full app embedding](./embedding/full-app-embedding.md)- [Securing embeds](./embedding/securing-embeds.md)- [AI agent resources](./embedding/ai-agent-resources.md)diff --git a/docs/dashboards/subscriptions.md b/docs/dashboards/subscriptions.mdindex c09edcf2106..072871dad49 100644--- a/docs/dashboards/subscriptions.md+++ b/docs/dashboards/subscriptions.md@@ -43,7 +43,6 @@ For Slack subscriptions, you can set up a subscription for a channel (like #geneYou can also send subscriptions to private channels, but that requires additional configuration, see [Sending alerts and subscriptions to private Slack channels](../configuring-metabase/slack.md#sending-alerts-and-subscriptions-to-private-slack-channels).-If you rename the subscribed channel in Slack, you'll need to update the subscription to point to the new Slack channel name.### Frequency and timing@@ -134,7 +133,7 @@ You can view a list of all alerts and dashboard subscriptions that people have s{% include plans-blockquote.html feature="Dashboard subscription filter customization" %}-You can customize which filter values to apply to each dashboard subscription. That way you can send an email (or Slack message) with the dashboard results to different groups of people, with different dashboard filters applied for each group. You only need to maintain one dashboard, which you can use to send results relevant to each subscriber. For example, send a dashboard filtered for "Marketing" department and "This week" date weekly to a marketing lead, and send the dashboard filtered for all departments and "This quarter" to the CEO.+You can customize which filter values to apply to each dashboard subscription. That way you can send an email (or Slack message) with the dashboard results to different groups of people, with different dashboard filters applied for each group. You only need to maintain one dashboard, which you can use to send results relevant to each subscriber. For example, send a dashboard filtered for "Marketing" department and "This week" date weekly to a marketing lead, and send the dashboard filtered for all departments and "This quarter" to the CEO.### Setting filter values@@ -158,9 +157,14 @@ See [Remove Metabase branding from exports](../questions/exporting-results.md#reSince people viewing embedded dashboards likely don't have direct access to your Metabase, Metabase will omit the links to Metabase items in subscriptions sent from embedded dashboards. That way people don't get broken links in their email. See [embedded dashboards](../embedding/components.md).+## Custom visualizations fall back to the default chart++Nobody's signed in when Metabase renders a subscription, so a card that uses a [custom visualization](../questions/visualizations/custom.md) falls back to the default visualization for its results.+## Further reading- [Alerts](../questions/alerts.md)- [Setting up email](../configuring-metabase/email.md)- [Setting up Slack](../configuring-metabase/slack.md)- [Usage analytics](../usage-and-performance-tools/usage-analytics.md)+- [Custom visualizations](../questions/visualizations/custom.md)diff --git a/docs/developers-guide/custom-visualizations.md b/docs/developers-guide/custom-visualizations.mdindex 1d0ae9a0faa..6ea2c57bed2 100644--- a/docs/developers-guide/custom-visualizations.md+++ b/docs/developers-guide/custom-visualizations.md@@ -420,9 +420,9 @@ For uploading and managing plugins, see [Custom visualizations](../questions/vis## Versioning and compatibility-The Custom Visualizations SDK works with Metabase 1.62 and newer. Declare the versions your plugin supports with `metabase.version` in `metabase-plugin.json`, using [npm semver range](https://github.com/npm/node-semver#ranges) syntax — for example, `">=1.62 <1.64"`. Keep the range closed on both ends: an open-ended range like `">=1.62.0"` claims compatibility with future Metabase versions your plugin has never run against. Write the range against the full version number (`">=1.62 <1.64"`), not a bare major version (`">=62 <64"`), which won't match.+Metabase runs two compatibility checks on a plugin, and neither one blocks anything (the plugin uploads and runs either way). When a check fails, Metabase shows a [compatibility warning](../questions/visualizations/custom.md#compatibility-warnings-are-heads-ups-not-errors) on the **Manage visualizations** page.-If a plugin's declared range doesn't include the Metabase version it's installed on — at upload time, or later after a Metabase upgrade — the plugin still uploads and runs, and Metabase shows a warning on the **Manage visualizations** page.+The second check is the Metabase version, which you declare yourself. Set `metabase.version` in `metabase-plugin.json` to an [npm semver range](https://github.com/npm/node-semver#ranges) like `">=1.62 <1.64"`, closed on both ends. Metabase versions are [license.major.minor](https://www.metabase.com/version-support), so include the license prefix: a bare `">=62 <64"` won't match anything.## Custom visualization limitations@@ -437,15 +437,15 @@ Metabase runs plugin code in an isolated sandbox, so a visualization works only- **Navigation and the rest of the app**: history changes, the host page's URL and referrer, and any DOM outside the plugin's own container.- **Unsafe DOM and timing APIs**: `document.write`, `execCommand`, constructable stylesheets, raw HTML parsers (`DOMParser`, `setHTMLUnsafe`, `XSLTProcessor`), and resource-timing APIs that expose other requests the page has made.-### When embedding, custom visualizations are only available in the SDK+### Custom visualizations only work in authenticated embeds-The [Modular embedding SDK](../embedding/sdk/introduction.md) renders custom visualizations when you allowlist them with the [`allowedCustomVisualizations` prop](../embedding/sdk/config.md#custom-visualizations) on `MetabaseProvider`.+[Modular embeds](../embedding/modular-embedding.md) can render custom visualizations when you allowlist them with the `allowedCustomVisualizations` setting, both with web components and with the [React SDK](../embedding/sdk/introduction.md). See [Custom visualizations in embeds](../embedding/custom-visualizations.md).-Other embedding types don't render custom visualizations. In [modular embedding](../embedding/modular-embedding.md) with web components and [public links](../embedding/public-links.md), any card that uses a custom visualization falls back to the default visualization for the query's results.+In [guest embeds](../embedding/introduction.md) and [public links](../embedding/public-links.md), any question that uses a custom visualization falls back to the default visualization for the query's results.### Custom visualizations don't render in exports and subscriptions-Static renders—like charts in alerts or dashboard subscriptions—fall back to a default visualization for the card's data shape.+Static renders (like charts in alerts or dashboard subscriptions) fall back to a default visualization for the query's data shape.## Example pluginsdiff --git a/docs/embedding/components.md b/docs/embedding/components.mdindex 297630758ca..a475bf5e4f4 100644--- a/docs/embedding/components.md+++ b/docs/embedding/components.md@@ -106,4 +106,5 @@ If you're using the [modular embedding SDK](./sdk/introduction.md), you can prov## Further reading- [Appearance](./appearance.md)+- [Custom visualizations in embeds](./custom-visualizations.md)- [Modular embedding SDK](./sdk/introduction.md).diff --git a/docs/embedding/custom-visualizations.md b/docs/embedding/custom-visualizations.mdnew file mode 100644index 00000000000..c66a31406a6--- /dev/null+++ b/docs/embedding/custom-visualizations.md@@ -0,0 +1,95 @@+---+title: Custom visualizations in embeds+summary: Enable custom visualizations in your embeds by adding them to your allowlist.+---++# Custom visualizations in embeds++{% include plans-blockquote.html feature="Custom visualizations" %}++Authenticated [modular embeds](./modular-embedding.md) can render [custom visualizations](../questions/visualizations/custom.md), whether you're embedding with web components or with the [React SDK](./sdk/introduction.md).++- [An admin has to turn on custom visualizations first](#an-admin-has-to-turn-on-custom-visualizations-first)+- [Add custom visualizations to your allowlist](#add-custom-visualizations-to-your-allowlist)+- [Set a Content Security Policy in your app](#set-a-content-security-policy-in-your-app)+- [Custom visualizations don't work in guest embeds](#custom-visualizations-dont-work-in-guest-embeds)++## An admin has to turn on custom visualizations first++Before an embed can render a custom visualization, an admin needs to [turn on custom visualizations](../questions/visualizations/custom.md#enabling-custom-visualizations) in your Metabase and upload the visualization. If the visualization doesn't exist in your Metabase, allowlisting its name in your app won't do anything.++To build a custom visualization, check out [Building custom visualizations](../developers-guide/custom-visualizations.md).++## Add custom visualizations to your allowlist++Embeds don't load custom visualizations by default. You have to list each visualization you want in the `allowedCustomVisualizations` allowlist. Any question that uses a custom visualization that isn't on the allowlist will fall back to the default visualization for that query's results.++Each entry in the allowlist is the custom visualization's name, prefixed with `custom:`. A custom visualization named `Calendar Heatmap` becomes `"custom:Calendar Heatmap"`. The name comes from the `name` in the visualization's plugin manifest. You can look it up in your Metabase under **Admin** > **Settings** > **Custom visualizations** > **Manage visualizations**.++Names are case-sensitive, so `"custom:calendar heatmap"` won't match a visualization named `Calendar Heatmap`. If an entry on your allowlist doesn't match an uploaded visualization, Metabase logs a warning to the browser console.++Where the allowlist goes depends on how you're embedding:++- [Web components](#web-components-allowlist-for-custom-visualizations)+- [React SDK](#react-sdk-allowlist-for-custom-visualizations)++### Web components allowlist for custom visualizations++`allowedCustomVisualizations` is a [page-level config](./modular-embedding.md#page-level-config), not an attribute on `<metabase-dashboard>` or `<metabase-question>`. The allowlist applies to every component on the page.++Add `allowedCustomVisualizations` to `defineMetabaseConfig()`:++```html+<!-- Load embedding library -->+<!-- REPLACE WITH YOUR METABASE URL HERE -->+<script defer src="https://your-metabase-url/app/embed.js"></script>++<!-- Embedding configuration -->+<script>+ function defineMetabaseConfig(config) {+ window.metabaseConfig = config;+ }+</script>++<script>+ defineMetabaseConfig({+ instanceUrl: "https://your-metabase-url",+ allowedCustomVisualizations: ["custom:Calendar Heatmap", "custom:Thumbs"],+ });+</script>++<metabase-dashboard dashboard-id="1"></metabase-dashboard>+```++If you create your embed through the [embed wizard](./modular-embedding.md#create-a-new-embed), Metabase fills in the allowlist with the custom visualizations that the dashboard or question you picked already uses, so the generated snippet works as-is.++### React SDK allowlist for custom visualizations++Pass the `allowedCustomVisualizations` prop to `MetabaseProvider`. Like the page-level config for web components, the allowlist is global: it applies to every embedded component under the provider, not to one question or dashboard.++```typescript+{% include_file "{{ dirname }}/sdk/snippets/config/config-with-custom-visualizations.tsx" snippet="example" %}+```++## Set a Content Security Policy in your app++A custom visualization runs third-party JavaScript in your app. Metabase runs that code in an isolated sandbox, so a visualization can't reach the rest of your app or make network requests. The sandbox doesn't block passive image loads, though: a visualization can still trigger outbound requests through `<img>` tags or CSS `url()`.++To limit where custom visualizations can load images from, set a [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP) with an `img-src` allowlist in your app. The core Metabase app sets this CSP with [Restrict image domains](../configuring-metabase/settings.md#restrict-image-domains), but you should also set a CSP in your app.++## Custom visualizations don't work in guest embeds++Custom visualizations only work when Metabase knows who's viewing the embed. [Guest embeds](./guest-embedding.md) ignore `allowedCustomVisualizations` (and log a warning to the console), and fall back to the default visualization.++Any embed with a signed-in person can load custom visualizations, including embeds you're previewing locally with an API key or your existing Metabase session. See [Authentication](./authentication.md).++### Public links, subscriptions, and alerts fall back to the default visualization++Nobody signs in to view a [public link](./public-links.md), and nobody's signed in when Metabase renders a [dashboard subscription or alert](../questions/alerts.md), so a question that uses a custom visualization falls back to the default visualization for its results in both cases.++## Further reading++- [Custom visualizations](../questions/visualizations/custom.md)+- [Building custom visualizations](../developers-guide/custom-visualizations.md)+- [Modular embedding](./modular-embedding.md)+- [Modular embedding components](./components.md)diff --git a/docs/embedding/guest-embedding.md b/docs/embedding/guest-embedding.mdindex b6aea106946..c3f749f8783 100644--- a/docs/embedding/guest-embedding.md+++ b/docs/embedding/guest-embedding.md@@ -533,6 +533,7 @@ Guest embeds can't take advantage of:- [Usage analytics](../usage-and-performance-tools/usage-analytics.md)- [Query builder](../questions/query-builder/editor.md)- [AI chat](./sdk/ai-chat.md)+- [Custom visualizations](./custom-visualizations.md)For those features, check out [Modular embedding with SSO](./modular-embedding.md).diff --git a/docs/embedding/introduction.md b/docs/embedding/introduction.mdindex 746f3b23a77..8ce3ddfd324 100644--- a/docs/embedding/introduction.md+++ b/docs/embedding/introduction.md@@ -71,6 +71,7 @@ All SSO options require a Pro or Enterprise plan.| [Collection browser](./sdk/collections.md) | ✅ | ❌ || Advanced [Tenant](./tenants.md) and [permissions](../permissions/embedding.md) management | ✅ | ❌ || [Advanced theming](./appearance.md) | ✅ | ❌ |+| [Custom visualizations](./custom-visualizations.md) | ✅ | ❌ || [Usage analytics](../usage-and-performance-tools/usage-analytics.md) | ✅ | ❌ || Customize layouts and behavior with [plugins](./sdk/plugins.md) | ✅ | ❌ || [Locked filters](./guest-embedding.md#locked-parameters)\*\*\* | ❌ | ✅ |@@ -106,7 +107,7 @@ For information about the anonymous usage data Metabase collects from embedded c## Embedding limitations- Currently, you can't embed [documents](../documents/introduction.md) (though you can create [public documents](./public-links.md)).-- Only the [Modular embedding SDK](./sdk/introduction.md) renders [custom visualizations](../questions/visualizations/custom.md), and only ones you allowlist with the [`allowedCustomVisualizations` prop](./sdk/config.md#custom-visualizations). In other embedding types, any card that uses a custom visualization falls back to the default visualization for the query's results.+- [Modular embeds](./modular-embedding.md) that use SSO can render [custom visualizations](../questions/visualizations/custom.md), but only the custom visualizations you add to your [allowlist](./custom-visualizations.md). Guest embeds fall back to the default visualization.## Further readingdiff --git a/docs/embedding/modular-embedding.md b/docs/embedding/modular-embedding.mdindex b99814737ac..45b4c7e04c9 100644--- a/docs/embedding/modular-embedding.md+++ b/docs/embedding/modular-embedding.md@@ -196,6 +196,8 @@ To define the configuration that applies to every embed on the page, use the `de- `pluginsConfig` : plugins to customize the behavior of embedded components. Use the `handleLink` function to customize what happens when people click a link in your embedded questions and dashboards. For details on the `handleLink` API, including code examples, see [`handleLink` plugin](./sdk/plugins.md#handlelink).+- `allowedCustomVisualizations: ["custom:Calendar Heatmap"]` (optional): the [custom visualizations](./custom-visualizations.md) that the components on the page are allowed to load. Not available in guest embeds.+## AuthenticationFor authentication setup including API keys for local testing, SSO with JWT/SAML, and cross-domain configuration, see [Modular embedding - authentication](./authentication.md).diff --git a/docs/embedding/public-links.md b/docs/embedding/public-links.mdindex 6b265ea81ed..53b4c90228f 100644--- a/docs/embedding/public-links.md+++ b/docs/embedding/public-links.md@@ -94,6 +94,8 @@ If you want to embed your question or dashboard as an iframe in a simple web pagTo customize the appearance of your question or dashboard, you can update the link in the `src` attribute with [public embed parameters](#public-embed-parameters).+Nobody signs in to view a public link or public embed, so a question that uses a [custom visualization](../questions/visualizations/custom.md) falls back to the default visualization for its results. To render custom visualizations, you'll need an authenticated [modular embed](./modular-embedding.md) with the visualization on your [allowlist](./custom-visualizations.md).+## Public embed parametersTo apply appearance or filter settings to your public embed, you can add parameters to the end of the link in your iframe's `src` attribute.@@ -195,3 +197,4 @@ Admins can see all publicly shared questions, dashboards, documents, and actions- [Publishing data visualizations to the web](https://www.metabase.com/learn/metabase-basics/embedding/charts-and-dashboards).- [Customizing Metabase's appearance](../configuring-metabase/appearance.md).- [Embedding introduction](../embedding/start.md).+- [Custom visualizations in embeds](./custom-visualizations.md).diff --git a/docs/embedding/sdk/config.md b/docs/embedding/sdk/config.mdindex 4921769216e..2cf6d74ea26 100644--- a/docs/embedding/sdk/config.md+++ b/docs/embedding/sdk/config.md@@ -34,18 +34,7 @@ To pass a theme, use `defineMetabaseTheme`. See [Reuse a saved theme in the SDK]## Custom visualizations-The SDK can render [custom visualizations](../../questions/visualizations/custom.md). To allow custom visualizations in the embed, pass an allowlist of the custom visualizations to the `allowedCustomVisualizations` prop on `MetabaseProvider`:--```typescript-{% include_file "{{ dirname }}/snippets/config/config-with-custom-visualizations.tsx" snippet="example" %}-```--Only the custom visualizations you list will load. Each entry is the visualization's name (the manifest `name`, which you can find under **Admin** > **Settings** > **Custom visualizations** > **Manage visualizations**), prefixed with `custom:`. For example, a custom visualization named `Calendar Heatmap` becomes `"custom:Calendar Heatmap"`. Names are case-sensitive, so `"custom:calendar heatmap"` won't match a visualization named `Calendar Heatmap`.--Omitting the prop, or passing an empty array, turns off custom visualizations. Cards that use a custom visualization will fall back to the default visualization for the query's results. If you allowlist a name that doesn't match an installed custom visualization, the SDK logs a warning to the console and falls back to the default visualization.---For security, the SDK runs each custom visualization's code in an isolated sandbox, so a visualization can't reach your app or make network requests. The sandbox doesn't block passive image loads, though. A visualization can still trigger outbound requests through `<img>` tags or CSS `url()`. To limit where custom visualizations can load images from, set a Content Security Policy with an `img-src` allowlist in your app (the core Metabase app does this with [Restrict image domains](../../configuring-metabase/settings.md#restrict-image-domains)). [Only add visualizations you trust](../../questions/visualizations/custom.md#only-add-visualizations-you-trust).+The SDK can render [custom visualizations](../../questions/visualizations/custom.md) that you allowlist with the `allowedCustomVisualizations` prop on `MetabaseProvider`. See [Custom visualizations in embeds](../custom-visualizations.md).## Global event handlersdiff --git a/docs/embedding/sdk/introduction.md b/docs/embedding/sdk/introduction.mdindex 6755331baa3..09aec59b09b 100644--- a/docs/embedding/sdk/introduction.md+++ b/docs/embedding/sdk/introduction.md@@ -110,6 +110,7 @@ Start with one of the quickstarts, then see these pages for more info on compone- [Actions](./actions.md)- [Appearance](../appearance.md)- [Collections](./collections.md)+- [Custom visualizations](../custom-visualizations.md)- [Plugins](./plugins.md)- [Config](./config.md)- [Versioning](./version.md)diff --git a/docs/embedding/start.md b/docs/embedding/start.mdindex fde29f25b56..2e36db99daa 100644--- a/docs/embedding/start.md+++ b/docs/embedding/start.md@@ -42,6 +42,10 @@ Every `<metabase-question>` attribute, the `StaticQuestion` and `InteractiveQuesGuest embedding is a secure way to embed charts and dashboards. Guest embeds are view-only; people won't be able to drill-through charts and tables.+### [Custom visualizations in embeds](./custom-visualizations.md)++Allowlist the custom visualizations that your embedded components can load. Available in modular embeds that use SSO, with web components or the React SDK.+### [Translating embeds](./translations.md)Upload a translation dictionary to translate questions and dashboards in modular embeds.diff --git a/docs/questions/alerts.md b/docs/questions/alerts.mdindex 45edc006bee..92e6ef9acfc 100644--- a/docs/questions/alerts.md+++ b/docs/questions/alerts.md@@ -162,9 +162,14 @@ See [Remove Metabase branding from exports](./exporting-results.md#remove-metabaSince people viewing embedded questions likely don't have direct access to your Metabase, Metabase omits links to Metabase items in alerts sent from embedded questions. That way people don't get broken links in their email.+## Custom visualizations fall back to the default chart++Nobody's signed in when Metabase renders an alert, so a question that uses a [custom visualization](./visualizations/custom.md) falls back to the default visualization for its results.+## Further reading- [Dashboard subscriptions](../dashboards/subscriptions.md)- [Setting up email](../configuring-metabase/email.md)- [Setting up Slack](../configuring-metabase/slack.md)- [Usage analytics](../usage-and-performance-tools/usage-analytics.md)+- [Custom visualizations](./visualizations/custom.md)diff --git a/docs/questions/visualizations/custom.md b/docs/questions/visualizations/custom.mdindex cb1b5a593c6..662281f3fca 100644--- a/docs/questions/visualizations/custom.md+++ b/docs/questions/visualizations/custom.md@@ -38,7 +38,7 @@ Once you've [built the custom visualization](../../developers-guide/custom-visua3. Click **Add visualization**.- Bundles must be smaller than 5 MiB.-- Each custom visualization lists the Metabase versions it supports (for example, "Requires Metabase >=1.62"). If your Metabase version isn't in that range, Metabase rejects the upload and tells you which version the visualization needs.+- Each custom visualization lists the Metabase versions it supports (for example, "Requires Metabase >=1.62 <1.64"). If your Metabase isn't in that range, the visualization still uploads and works, but Metabase adds a [compatibility warning](#compatibility-warnings-are-heads-ups-not-errors).- The **Manage visualizations** page shows each custom visualization's icon, name, the first eight characters of the bundle's hash, and its required Metabase version range, so you can tell which version is installed.## Using a custom visualization@@ -55,11 +55,11 @@ Custom visualizations behave like built-in charts in most places:- **Dark mode.** Custom visualizations that use Metabase's colors adapt to [dark mode](../../people-and-groups/account-settings.md#theme) automatically.- **Icons.** A custom visualization shows its own icon in the visualization picker, and questions that use it show that icon in collections and bookmarks.-### Custom visualizations in embeds only work when using the SDK+### Custom visualizations in embeds only work when people are signed in-The [Modular embedding SDK](../../embedding/sdk/introduction.md) can render custom visualizations. You allowlist the custom visualizations you want to load with the [`allowedCustomVisualizations` prop](../../embedding/sdk/config.md#custom-visualizations) on `MetabaseProvider`.+[Modular embeds](../../embedding/modular-embedding.md) that use SSO can render custom visualizations, whether you embed with web components or with the [React SDK](../../embedding/sdk/introduction.md). You allowlist the custom visualizations you want to load with the `allowedCustomVisualizations` setting. See [Custom visualizations in embeds](../../embedding/custom-visualizations.md).-Other embedding types don't render custom visualizations. In [modular embedding](../../embedding/modular-embedding.md) with web components, [guest and static embeds](../../embedding/introduction.md), and [public links](../../embedding/public-links.md), any card that uses a custom visualization falls back to the default visualization for the query's results.+Embeds without an authenticated person don't render custom visualizations. In [guest and static embeds](../../embedding/introduction.md) and [public links](../../embedding/public-links.md), any card that uses a custom visualization falls back to the default visualization for the query's results.## Managing custom visualizations@@ -69,6 +69,13 @@ _Admin > Settings > Custom visualizations > Manage visualizations_- **Replace a bundle.** Upload a new `.tgz` to ship an updated version of a custom visualization. The new bundle's manifest `name` _must_ match the existing visualization's identifier, so questions that already use the visualization keep working.- **Remove a visualization.** Cards that used the custom viz fall back to the default visualization.+### Compatibility warnings are heads-ups, not errors++Metabase flags a custom visualization on the **Manage visualizations** page when:++- **The SDK version doesn't match.** The visualization was built with a version of the Custom Visualizations SDK that your Metabase wasn't tested against.+- **The Metabase version doesn't match.** A visualization that was in range when you uploaded it can fall out of range when you upgrade Metabase, so this warning can show up on a visualization that's been working for months.+## Exports- **Dashboard subscriptions and alerts don't use custom visualizations**. Cards that use custom visualizations will fall back to a default visualization for the card's data shape.