Metabase documentation

Metabase is an open-source business intelligence platform. You can use Metabase to ask questions about your data, or embed Metabase in your app to let your customers explore their data on their own.

Run as a JAR, using Docker, or on Metabase Cloud.

Once installed, set up your Metabase and connect to your data.

With your data connected, get started asking questions, creating dashboards, and sharing your work.

Metabase is a deep product with a lot of tools to simplify business intelligence, from embeddable charts and interactive dashboards, to GUI and SQL editors, to auditing and data sandboxing, and more.

Metabase’s reference documentation.

• Installation overview
• Installing Metabase
• Upgrading Metabase
• Configuring the Metabase application database
• Backing up Metabase
• Migrating to a production application database
• Java versions
• Monitoring your Metabase
• Serialization
• Supported browsers
• Privacy

• Databases overview
• Adding and managing databases
• Encrypting your database connection
• SSH tunneling
• SSL certificate

• Questions overview

Query builder

• Asking questions
• Visualizing data
• Custom expressions
• List of expressions
• Joining data

SQL and native queries

• The SQL editor
• SQL parameters
• Referencing models and saved questions
• SQL snippets
• SQL snippet folder permissions

Sharing

• Sharing answers
• Alerts
• Public sharing

• Dashboards overview
• Introduction to dashboards
• Dashboard filters
• Interactive dashboards
• Charts with multiple series
• Dashboard subscriptions

• Data modeling overview
• Models
• Data model admin settings
• Field types
• Formatting defaults
• Segments and metrics

• Organization overview
• Basic exploration
• Collections
• History
• Data reference
• Events and timelines
• X-rays

• People overview
• Account settings
• Managing people and groups
• Password complexity
• Session expiration
• Google Sign-In or LDAP

Paid SSO options

• JWT-based authentication
• SAML-based authentication
  • SAML with Auth0
  • SAML with Azure AD
  • SAML with Google
  • SAML with Keycloak
  • SAML with Okta

• Permissions overview
• Permissions introduction
• Data permissions
• Collection permissions
• Application permissions
• Data sandboxes
• SQL snippets folder permissions

• Embedding overview
• Embedding introduction
• Full-app embedding
• Signed embedding
• Parameters for signed embeds

• Configuration overview
• Setting up Metabase
• General settings
• Email
• Slack
• Environment variables
• Configuration file
• Metabase log configuration
• Timezones
• Languages and localization
• Appearance
• Caching query results
• Custom maps
• Customizing the Metabase Jetty webserver

• Tools overview
• Auditing tools
• Admin tools

• Metabase API documentation
• API tutorial

• Troubleshooting guides

• Developer guide

• Troubleshooting guides
• Metabase forum
• Configuring logging

Learn Metabase has a ton of articles on how to use Metabase, data best practices, and more.

Share and connect with other Metabasers.

Some Metabase plans offer additional features.

For docs specific to Metabase Cloud plans.

Practical advice from our community.

News, updates, and ideas.

Real companies, real data, real stories.

We tweet stuff.

Follow us on GitHub.

Contribute to the Metabase open source project!

Data jargon explained.

If you’d like more technical resources to set up your data stack with Metabase, connect with a Metabase Expert.