Troubleshooting guides

Problems, their causes, how to detect them, and how to fix them.

Getting diagnostic info

Installation

Authentication

Permissions

Databases

Questions and dashboards

Models

Email and alerts

Error messages

Think you found a bug?

Feature requests

See Requesting new features.

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.

Want to improve these docs? Propose a change.