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.49.

Troubleshooting filters

It’s always a good idea to start with a quick sanity check:

  1. Clear your browser cache.
  2. Refresh the page.
  3. Open your question or dashboard in an incognito window.

Dashboard filters

If a dashboard filter is giving you no results or the wrong results:

  1. Click the pencil icon to go into edit mode.
  2. Click the gear icon beside your filter widget.
  3. Make sure you’ve selected a column for your filter under Column to filter on.
  4. If you can’t find the right Column to filter on, or you’re getting “No Results” when you apply the filter:
    • Exit edit mode and click on a dashboard card to go to the original question.
    • Follow the troubleshooting steps under Question filters.

Question filters

If a question filter is giving you no results or the wrong results:

  1. Make sure the question includes the column you want to filter on.
  2. Check that the column actually contains the value(s) you’re filtering on. You can do this by:
    • sorting number or date columns,
    • creating a “contains” filter for string columns, or
    • asking your database admin.
  3. Ask your Metabase admin to help you check if:

Special cases

If you’re having trouble filtering on a:

Explanation

When we first set up a filter, we need to link the filter to a column. If we make the wrong assumptions about a column’s values or data type, the filter won’t work at all. If a column changes on the database side, the filter might suddenly stop working.

For example, let’s say we want to create a filter named “Select Product ID” linked to a column named Product ID. The filter won’t work if any of these things happen:

  • Our question doesn’t include the Product ID column.
  • We type the number 4 into the “Select Product ID” filter, when the Product ID column only contains the values 1, 2, and 3.
  • Product ID is renamed to something else in the database or Table Metadata page.
  • Product ID is deleted from the database, or hidden in the Table Metadata page.
  • Product ID is a custom column that’s not working as expected.
  • We don’t have data permissions to access the Product ID column.
  • We made “Select Product ID” a numerical filter, but Product ID is a string column (see the section below).

Time, ID, and number filters

To debug dashboard and question filters that involve timestamps, UUIDs, or numeric data:

  1. Find the data type of the column that you want to filter on. You can find this info from:
  2. Cast the column to a data type that matches the desired filter type. You can:

If you’re not a Metabase admin, you might have to ask your admin to help you with some of these steps.

Explanation

Metabase needs to know the data type of a column in order to present you with a curated selection of filter types. Sometimes these columns are mistyped—if a column stores your numbers as strings, Metabase will only show you text or category filters (with options like “is”, “is not”) instead of number filters (with options like “greater than”, “less than”).

Timestamps, in particular, are the root of all evil, so please be patient with your Metabase admin (or yourself!) when trying to get the data type right.

Missing or incorrect filter values

If your filter dropdown menu displays the wrong values for a column:

  1. Go to Admin settings > Table Metadata.
  2. Find your database, table, and column.
  3. Click the gear icon at the right of a column’s settings box.
  4. Scroll to Cached field values.
  5. Optional: click Discard cached field values.
  6. Click Re-scan this field.

Explanation

Metabase scans get the values for your filter dropdown menus by querying and caching the first 1,000 distinct records from a table. You might see outdated filter values if your tables are getting updated more frequently compared to your scan schedule.

Are you still stuck?

If you can’t solve your problem using the troubleshooting guides:

Read docs for other versions of Metabase.

Thanks for your feedback!

Want to improve these docs? Propose a change.