These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.50.
Troubleshooting guides
Problems, their causes, how to detect them, and how to fix them.
Getting diagnostic info
Installation
- Running the Metabase JAR.
- Running Metabase on Docker.
- Using or migrating from an H2 application database.
Authentication
Permissions
Databases
- I can’t connect to a database.
- I can’t see my tables.
- The data in Metabase doesn’t match my database.
- My database is slow.
- My connection or query is timing out.
Questions and dashboards
- I can’t save my question or dashboard.
- I can’t view or edit my question or dashboard.
- My visualizations are wrong.
- My dashboard is slow or failing to load.
- My SQL question doesn’t work.
- The dates and times in my questions and charts are wrong.
- My filters don’t work.
- My linked filters don’t work.
Models
Email and alerts
Error messages
Think you found a bug?
Feature requests
Metabase tutorials
For tutorials that walk you through how to use Metabase features, check out Learn Metabase.
Metabase forum
To see if someone else has run into a similar issue, check out our forum on Discourse.
Upgrading Metabase
Metabase adds new features and squashes bugs with each release. Upgrading to the latest and greatest may resolve your issue. If you’re using Metabase Cloud, we’ll handle the upgrades for you. To see what’s new, check out the release notes.
Read docs for other versions of Metabase.