Embedding introduction

You can embed Metabase tables, charts, dashboards, AI chat—even Metabase’s query builder—in your website or application.

There are two ways to embed Metabase.

• Modular embedding: embed individual Metabase components, like questions, dashboards, and AI chat, so they seamlessly integrate with your app.
• Full app embedding: embed the full Metabase app in an iframe, styled like your branding.

Most people go with modular embedding, so you can integrate Metabase components into your app.

If you just want to share a chart or dashboard with anyone who has the link, and you don’t need any authentication, take a look at public links and embeds.

Modular embedding

With modular embedding, you can embed individual Metabase components in your web app. You can use guest embeds for basic functionality, or use SSO to take full advantage of Metabase.

You can use two different ways to authenticate modular embeds:

• SSO
• Guest

SSO embeds

With SSO, Metabase can know who’s viewing what, which unlocks a lot of power. You can automatically apply data permissions, which means you can give people access to all the cool tools Metabase provides, and everyone will only ever see the data they’re allowed to.

When to use SSO: You want to offer multi-tenant, self-service analytics, or you want to include the query builder, AI chat, drill-through, or a collection browser.

If you’re building a SaaS product with embedded analytics for multiple customers, you can keep customer data isolated with Tenants.

Accounts for these embedded users in your Metabase count toward the accounts billed in your Metabase plan. But by letting your customers self-serve their data, you save time on developing bespoke charts. And you can charge more for a premium analytics experience. If you plan on giving a lot of your customers self-service access to their data, you should consider an enterprise plan, with custom pricing that scales with your business.

Guest embedding

Guest embeds are a secure way to embed charts and dashboards. Guest embedding works on all Metabase plans, including OSS and Starter.

When to use guest embeds: simple embedding use cases where you don’t want to offer ad-hoc querying or chart drill-through. To filter data relevant to the viewer, you can use guest embeds with locked parameters.

Set up modular embeds with web components or React

Whichever way you authenticate, you can set up modular embeds two ways.

• Web components: a script tag plus HTML elements like <metabase-question>. Web components have no build step and no framework requirement, so they work in plain HTML, Vue, Svelte, Rails, React, or any framework you like. Metabase’s in-app wizard writes the code for you.
• React SDK: React components that you import and compose yourself. The SDK gives you more control: you can build custom layouts and customize behavior with plugins.

If your app runs on React and you want that extra control, go with the SDK. Otherwise start with web components. You can always move to the SDK later.

Comparison between SSO and guest embeds

All SSO options require a Pro or Enterprise plan.

Feature	SSO	Guest
Charts	✅	✅
Dashboards	✅	✅
Filter widgets	✅	✅
Export results*	✅	✅
Basic appearance customization**	✅	✅
Row-level data segregation	✅	✅
Drill-through menus	✅	❌
Query builder	✅	❌
SQL editor	✅	❌
AI chat	✅	❌
Collection browser	✅	❌
Advanced Tenant and permissions management	✅	❌
Advanced theming	✅	❌
Usage analytics	✅	❌
Customize layouts and behavior with plugins	✅	❌
Locked filters***	❌	✅

* Each embedding type allows data downloads by default, but only Pro and Enterprise plans can disable data downloads.

** Requires a Pro and Enterprise plan for any embedding type.

*** SSO embeds don’t need locked filters. Since Metabase knows who’s viewing an SSO embed, you can segregate data with permissions instead. There’s a little more set up, but much less long-term overhead.

Full app embedding

Full app embedding allows you to embed the entire Metabase app in an iframe, and integrate Metabase SSO with your app’s authentication.

Public links and embeds

If you’d like to share your data with the good people of the internet, admins can create a public link or embed a question or dashboard directly in your website. A public link is a URL you can hand to anyone. A public embed is an iframe snippet you drop into one of your pages. Neither one is really an embedding setup — there’s no authentication, and anyone with the link can see the data.

When to use public links and embeds: one-off charts and dashboards. Admins can use public links 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 the item available to everyone.

Resources for AI agents

If you’re using an AI agent to help you embed Metabase in your app, check out AI agent resources.

Tracking embed usage

Usage Analytics tracks embed usage, including embedding context, authentication methods, hostname, and other metadata. Check out the Embedding usage dashboard.

For information about the anonymous usage data Metabase collects from embedded components, see Embedding telemetry.

Embedding limitations

• Currently, you can’t embed documents (though you can create public documents).
• Only the Modular embedding SDK renders custom visualizations, and only ones you allowlist with the allowedCustomVisualizations prop. In other embedding types, any card that uses a custom visualization falls back to the default visualization for the query’s results.

Further reading

• Strategies for delivering customer-facing analytics.
• Publishing data visualizations to the web.
• Multi-tenant self-service analytics.
• Customizing Metabase’s appearance.
• Securing embedded Metabase.