Metabase concepts

A quick overview of the core concepts in Metabase.

Overview

Metabase is a “Business intelligence” (BI) platform that gives you a bunch of tools to understand and share your data. Companies typically use Metabase to give their teams an easy way to query data, or to embed Metabase in their application to let customers explore data on their own.

You can use Metabase to:

  • Query your database using either:
  • View results as tables or charts (which you can customize)
  • Save results as Questions that can be added to:
  • Add multiple questions to dashboards.
  • Add dashboard filters that update all questions at once.
  • Organize questions and dashboards into collections.
  • Create Models to curate datasets, making it easier for people to query commonly filtered or joined data.
  • Create Metrics to standardize how your team calculates important numbers.

Core concepts

Metabase has a lot of tools, but here is the basic toolbox:

  • Questions are saved queries with visualizations that you can to dashboards or collections. Questions are the charts you can organize on dashboards.
  • Dashboards group related questions (charts) that can be filtered and refreshed together.
  • Collections are like folders to organize and manage permissions for your questions, dashboards, and other items.
  • Models are like views that curate data from your database.
  • Metrics define the official way to calculate important numbers for your team.

Questions

Question

Questions are saved queries plus their visualization (you can toggle between a table and a chart).

You can also:

  • Set up alerts on questions to get notified when your data meets certain conditions.
  • Export results of questions to CSV, XLSX, or JSON (or PNG for charts).

There are two main ways to create questions: the query builder, and the native code editor:

Query Builder

Query builder

The query builder lets you create questions without knowing SQL. It provides a point-and-click interface where you can:

Even SQL experts often use the query builder because:

  • It’s faster. You can drill through charts, group results, and iterate on a question just by clicking around.
  • Metabase will pick a chart for you (which you can change and customize manually).
  • The charts the query builder produces are interactive: you can drill through charts to explore further (unlike charts built with the native code editor).
  • You can hand off the question to people who don’t know SQL.
  • It’s surprisingly powerful: see Custom expressions.

Native query editor

Native query editor

If you know SQL (or your database’s query language), you can also create questions with the native editor. You can:

  • Write complex queries with reusable code saved as snippets.
  • Use parameters to make your queries dynamic and reusable.
  • Reference models and saved questions in your SQL.
  • Use database-specific functions.
  • Do things that might not be possible in the query builder.

There is one drawback compared to the query builder: unlike the questions built with the query builder, people won’t be able to drill through your charts.

Dashboards

A dashboard in Metabase

Dashboards are a way to group and present related questions.

With dashboards, you can:

Collections

Collections

Collections work like folders. They’re like the file system for Metabase. You can use collections to:

  • Group related content together: questions, dashboards, models, and metrics. For example, to group all items for a specific team.
  • Mark items as official (pro feature).
  • Nest collections within other collections.
  • Add events and timelines to track key dates and milestones.

Models

Models are your clean, curated datasets that help people get started on the right foot. They’re like a well-organized spreadsheet that combines data from different places and adds helpful calculations. You can create models to:

  • Combine and filter data from multiple tables.
  • Include helpful calculations and cleaned-up fields.
  • Provide clear descriptions and semantic types (like “Price”).

For example, say you have an e-commerce database with separate tables for orders, people, and products. You could create a “Customer Orders” model that:

  • Joins together frequently used columns from these different tables.
  • Adds useful calculated fields like “Total Lifetime Value”.
  • Filters out test orders.
  • Includes clear descriptions of what each field means.

Now anyone can use the model as a starting point for new questions, without having to wrangle the underlying data each time.

Metrics

Metrics

Instead of everyone calculating important numbers (like revenue, active users, etc.) in their own way, you can standardize these calculations as metrics.

With metrics, you can:

  • Create a single source of truth for important calculations.
  • Include these calculations in any question, dashboard, or collection.

For example, say you want to track your company’s revenue. You could create a “Monthly Revenue” metric that:

  • Grabs data from your orders table.
  • Excludes canceled orders.
  • Sums the total.
  • Groups by month.

That way anyone can use the “Monthly Revenue” metric in their questions and dashboards, and you won’t have to deal with different revenue numbers in different dashboards.

One last tip

Press cmd + k (Mac) or ctrl + k (Windows/Linux) to bring up the command palette. You can use it to:

  • Search across all your Metabase content.
  • Jump to specific items (questions, dashboards) or pages (like Admin settings).
  • Create new questions and dashboards.
  • Access recent items.
  • Find documentation.

Bon voyage!

Next: Advanced Metabase features for data analysts

Set up alerts, annotate charts with events, model data, templatize SQL queries, customize click behavior, and more.

Next article