Metabase Not Working? Common Errors & Fixes
The 14 Metabase problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Metabase Dashboard Slow or Not Loading
Workaround availableMetabase Cloud, self-hostedMetabase dashboards slow down when many cards query the database at once, queries scan raw tables, or the database itself is slow. Split the dashboard into smaller ones (10 cards or fewer), filter queries and turn on caching.
Metabase 'Your Question Took Too Long' Error
Workaround availableMetabase Cloud, self-hostedThis error usually means something between Metabase and the database cut the request, very often a load balancer or Nginx proxy with a 60-second timeout. Raise the proxy timeout, then speed up the query itself.
Metabase Not Syncing New Tables or Columns
Workaround availableMetabase Cloud, self-hostedMetabase only sees schema changes after a sync. Trigger Sync database schema in Admin > Databases, check Admin > Tools > Logs for errors, and update drivers if you self-host.
Metabase Filter Dropdown Not Showing Values
Workaround availableMetabase Cloud, self-hostedDropdowns only appear for fields Metabase treats as categories with scanned values, and it samples only the first 1,000 unique values. Set the field to a dropdown in Table Metadata, then discard cached values and re-scan.
Metabase Linked Filters Not Working
Workaround availableMetabase Cloud, self-hostedLinked filters need an explicit foreign key relationship between the tables and must be linked in the right direction. Define the foreign key in Table Metadata, check the link direction and avoid using models or saved questions as the filter source.
Metabase Not Sending Emails or Alerts
Workaround availableSelf-hosted; Metabase Cloud with custom SMTP (Pro)Most cases are wrong SMTP settings or a mail service that blocks the sender or recipient domain. Send a test email from Admin > Email, read the error in Admin > Tools > Logs, and check spam and DKIM if mail is sent but not received.
Metabase Can't Connect to Database
Workaround availableMetabase Cloud, self-hostedCheck whether the problem is on the Metabase side (connection settings, version support) or the database side (server down, network or IP allowlist, credentials, privileges). On Metabase Cloud, add Metabase's IP addresses to your database allowlist.
Metabase Tables Not Showing
Workaround availableMetabase Cloud, self-hostedTables disappear from Metabase when they are hidden in Table Metadata, blocked by group permissions, renamed or dropped in the database, or the browser shows a stale list. Run SELECT 1 and SELECT * FROM the table in the SQL editor to find which.
Metabase Dates and Times Wrong (Timezone Off)
Workaround availableMetabase Cloud, self-hostedDates shift by hours or a whole day when Metabase's report time zone, the JVM time zone and the database's time zone don't line up. Set the report time zone in Admin > Settings > Localization, or match the JVM time zone to the database.
Metabase Docker Data Lost After Restart
Workaround availableSelf-hosted (Docker)If the setup screen appears every time the container restarts, Metabase's application database lived inside the container. Mount a persistent volume, and for production move from H2 to PostgreSQL.
Metabase OutOfMemoryError: Java Heap Space
Workaround availableSelf-hosted (JAR, Docker, Kubernetes)Metabase runs on the JVM and crashes with 'java.lang.OutOfMemoryError: Java heap space' when the heap is too small for syncs or heavy queries. Raise the heap with -Xmx (JAVA_OPTS in Docker) and capture a heap dump if it keeps happening.
Metabase 'Database Has Migration Lock' After Upgrade
Workaround availableSelf-hostedA previous upgrade or crash left a lock in the application database, so Metabase refuses to start. Make sure no other instance is running, back up the database, then release the lock with java -jar metabase.jar migrate release-locks.
Metabase Can't Log In or Forgot Admin Password
Workaround availableMetabase Cloud, self-hostedUsers can be reset by an admin from the People page. A self-hosted admin who is locked out can generate a reset token with java -jar metabase.jar reset-password; Metabase Cloud admins must contact support.
How to Cancel Metabase Cloud Subscription
Workaround availableMetabase Cloud (web, Metabase Store)Cancel Starter or Pro in the Metabase Store: Instances > Settings > Cancel subscription and delete instance. Cancelling deletes the instance, so ask support for an application database backup first if you want to keep your work. Enterprise must contact support.
SANDBOX · metabase RUNS IN YOUR BROWSER
Try it: browse a sample shop and watch visitors, funnels and live data arrive
A hands-on Metabase-style sandbox, including the spots where users get stuck. 1-2 minutes, nothing is saved.
Problem not listed? See all Metabase complaints or compare Metabase alternatives.
// The alternative nobody mentions
Need something Metabase can't do? We'll build it.
We're a small team of developers who build custom software fast. Your own Metabase alternative with only the features you use, or anything else: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code