Skip to main content
You can embed Metabase tables, charts, and dashboards—even Metabase’s query builder—in your website or application. Metabase offers multiple embedding approaches to fit different use cases, from simple public sharing to sophisticated multi-tenant analytics.

​
Embedding approaches

Metabase provides three main approaches for embedding analytics:

Modular embedding

Embed individual components like charts, dashboards, and query builder with SSO or guest authentication

Full app embedding

Embed the entire Metabase application in an iframe with SSO integration

Public sharing

Share charts and dashboards publicly via links or simple embeds

​
Modular embedding

With modular embedding, you can embed individual Metabase components in your web app. This approach gives you the most flexibility and control over the embedded experience.

​
Two ways to implement modular embedding

The Modular embedding SDK is a React library that provides pre-built components for embedding Metabase into React applications. It offers advanced theming, custom layouts, and plugins for customization.Best for: React applications that need maximum customization and controlLearn more about the SDK

​
Authentication options

You can use two different authentication methods with modular embedding:

​
SSO embeds

With SSO, Metabase can know who’s viewing what, which unlocks powerful features:
  • Automatic data permissions enforcement
  • Drill-through on charts and dashboards
  • Query builder access for ad-hoc exploration
  • AI chat for natural language queries
  • Collection browser
  • Multi-tenant, self-service analytics
SSO embeds require a Pro or Enterprise plan.
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.

​
Guest embedding

Guest embeds are a secure way to embed charts and dashboards without requiring individual user accounts. Guest embedding works on all Metabase plans, including open source and Starter.
  • Simple, secure embedding for charts and dashboards
  • No individual user accounts required
  • Filter data with locked parameters
  • Works on all Metabase plans
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.

​
Full app embedding

Full app embedding allows you to embed the entire Metabase app in an iframe, integrating Metabase SSO with your app’s authentication. This gives users access to all of Metabase’s functionality within your application.
If you’re just starting out with Metabase embedding, consider using modular embedding instead—it’s more customizable and offers better control over individual components.
When to use full app embedding:
  • You want to embed all of Metabase’s functionality
  • You need a complete analytics workspace within your app
  • You’re okay with less control over specific UI components
Learn more about full app embedding If you’d like to share your data publicly, admins can create public links or embed a question or dashboard directly in your website.
  • No authentication required
  • Share with anyone on the internet
  • Simple iframe embeds
  • Export options for CSV, XLSX, and JSON
When to use public links and embeds: One-off charts and dashboards that you want to make available to everyone, without any authentication or data restrictions. Learn more about public sharing

​
Comparison of embedding types

The SDK refers to the React Embedding SDK, which is the most feature-rich embedding option.
FeatureSDKModular SSOModular GuestFull appPublic
Charts and dashboards✅✅✅✅✅
Filter widgets✅✅✅✅✅
Export results✅✅✅✅✅
Locked filters❌❌✅❌❌
Data segregation✅✅❌✅❌
Drill-through menu✅✅❌✅❌
Query builder✅✅❌✅❌
Basic appearance customization✅✅✅✅✅
Advanced theming✅✅❌❌❌
Usage analytics✅✅❌✅❌
Embed individual components✅✅❌❌❌
Manage access per component✅✅❌❌❌
Custom layouts✅❌❌❌❌
Customize behavior with plugins✅❌❌❌❌
AI chat✅✅❌✅❌
  • Each embedding type allows data downloads by default, but only Pro and Enterprise plans can disable data downloads.
  • Basic appearance customization requires a Pro or Enterprise plan for any embedding type.

​
Which embedding approach should you choose?

1

Determine your use case

2

Consider your authentication requirements

  • No authentication needed? Use public sharing or guest embedding
  • Multi-tenant with per-user permissions? Use SSO with modular or full app embedding
  • React application? Use the React SDK for best developer experience
3

Evaluate customization needs

  • Need custom layouts? Use the React SDK
  • Want to customize click behaviors? Use the SDK with plugins
  • Basic theming is enough? Use modular embedding or full app embedding

​
Getting started

React Embedding SDK

Start with the SDK for React applications

Modular embedding

Use web components for any framework

Full app embedding

Embed the complete Metabase experience

Public sharing

Create public links and embeds

​
Further reading

Build docs developers (and LLMs) love

Get started for freeTalk to us