From c0899f599fb5b4463b39727343c84d6ad7cc3368 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 29 Jun 2026 11:16:53 +0000
Subject: [PATCH 1/2] docs: document dimension filter_autocomplete config
---
references/dimensions.mdx | 104 ++++++++++++++++++++++++++++++++++++++
1 file changed, 104 insertions(+)
diff --git a/references/dimensions.mdx b/references/dimensions.mdx
index c52ccc35..e382a71d 100644
--- a/references/dimensions.mdx
+++ b/references/dimensions.mdx
@@ -170,6 +170,7 @@ The table below shows all the dimension properties you can customize:
| [colors](#color) | No | Object with `value`, `color` | Color for the values in the chart |
| [image](#image-display) | No | Object with `url` | **[WIP]** Display images in table cells using URL templates. Supports LiquidJS templating for dynamic URLs. |
| [case_sensitive](#case-sensitive) | No | boolean | If set to `false`, string filters on this dimension will be case insensitive. Defaults to `true`. Overrides explore-level setting. |
+| [filter_autocomplete](#filter-autocomplete) | No | Object with `values`, `fetch_from_warehouse` | Configure the filter autocomplete suggestions for this dimension. Provide a static list of `values` (with optional display `label`s) and/or disable warehouse-based autocomplete by setting `fetch_from_warehouse: false`. |
| [tags](#tags) | No | string[] | An array of string tags for categorizing and filtering dimensions programmatically. Tags can be used by AI agents, API filters, and other backend workflows. |
| [convert_timezone](#convert-timezone) | No | boolean | **[Experimental]** If set to `false`, the dimension opts out of the project query timezone for display, grouping, and extracts - the raw warehouse value is rendered instead. Defaults to `true`. Has no effect unless a project query timezone is set. |
@@ -1666,6 +1667,109 @@ So with `case_sensitive: false`, filtering for `john` would match `John`, `JOHN`
+## Filter autocomplete
+
+You can customize the suggestions users see when filtering on a dimension. This is useful when you want to:
+
+- Provide a curated, static list of suggested values (with optional human-friendly labels) instead of relying solely on values from your warehouse.
+- Disable the live warehouse lookup for autocomplete to reduce warehouse queries on dimensions with very high cardinality or sensitive values.
+
+### Properties
+
+| Property | Required | Value | Description |
+| :------- | :------- | :---- | :---------- |
+| values | No | Array of `value`, `label` | A static list of suggested filter values. `value` is the raw value used in the filter; `label` is the optional display name shown in the autocomplete dropdown. Duplicate `value`s are ignored (the first occurrence wins). |
+| fetch_from_warehouse | No | boolean | If set to `false`, Lightdash won't query the warehouse for autocomplete suggestions on this dimension. Defaults to `true`. |
+
+### Static suggested values with labels
+
+
+
+ ```yaml
+ columns:
+ - name: status
+ description: 'Subscription status'
+ meta:
+ dimension:
+ filter_autocomplete:
+ values:
+ - value: 'active'
+ label: 'Active customer'
+ - value: 'trial'
+ label: 'Trial'
+ - value: 'churned'
+ ```
+
+
+ ```yaml
+ columns:
+ - name: status
+ description: 'Subscription status'
+ config:
+ meta:
+ dimension:
+ filter_autocomplete:
+ values:
+ - value: 'active'
+ label: 'Active customer'
+ - value: 'trial'
+ label: 'Trial'
+ - value: 'churned'
+ ```
+
+
+ ```yaml
+ dimensions:
+ - name: status
+ description: 'Subscription status'
+ filter_autocomplete:
+ values:
+ - value: 'active'
+ label: 'Active customer'
+ - value: 'trial'
+ label: 'Trial'
+ - value: 'churned'
+ ```
+
+
+
+### Disabling warehouse autocomplete
+
+Set `fetch_from_warehouse: false` to stop Lightdash from querying your warehouse for autocomplete suggestions on this dimension. Users can still type values manually; if you also provide `values`, those will be shown as suggestions.
+
+
+
+ ```yaml
+ columns:
+ - name: customer_email
+ meta:
+ dimension:
+ filter_autocomplete:
+ fetch_from_warehouse: false
+ ```
+
+
+ ```yaml
+ columns:
+ - name: customer_email
+ config:
+ meta:
+ dimension:
+ filter_autocomplete:
+ fetch_from_warehouse: false
+ ```
+
+
+ ```yaml
+ dimensions:
+ - name: customer_email
+ filter_autocomplete:
+ fetch_from_warehouse: false
+ ```
+
+
+
+
## Image Display
From 7a892e8e49efcabc2997e7c81cd35c70123c917b Mon Sep 17 00:00:00 2001
From: Jose Rego
Date: Mon, 29 Jun 2026 13:26:24 +0100
Subject: [PATCH 2/2] Update references/dimensions.mdx
---
references/dimensions.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/references/dimensions.mdx b/references/dimensions.mdx
index e382a71d..9fc3415e 100644
--- a/references/dimensions.mdx
+++ b/references/dimensions.mdx
@@ -170,7 +170,7 @@ The table below shows all the dimension properties you can customize:
| [colors](#color) | No | Object with `value`, `color` | Color for the values in the chart |
| [image](#image-display) | No | Object with `url` | **[WIP]** Display images in table cells using URL templates. Supports LiquidJS templating for dynamic URLs. |
| [case_sensitive](#case-sensitive) | No | boolean | If set to `false`, string filters on this dimension will be case insensitive. Defaults to `true`. Overrides explore-level setting. |
-| [filter_autocomplete](#filter-autocomplete) | No | Object with `values`, `fetch_from_warehouse` | Configure the filter autocomplete suggestions for this dimension. Provide a static list of `values` (with optional display `label`s) and/or disable warehouse-based autocomplete by setting `fetch_from_warehouse: false`. |
+| [filter_autocomplete](#filter-autocomplete) | No | Object | Configure the filter autocomplete suggestions for this dimension. Provide a static list of `values` (with optional display `label`s) and/or disable warehouse-based autocomplete by setting `fetch_from_warehouse: false`. |
| [tags](#tags) | No | string[] | An array of string tags for categorizing and filtering dimensions programmatically. Tags can be used by AI agents, API filters, and other backend workflows. |
| [convert_timezone](#convert-timezone) | No | boolean | **[Experimental]** If set to `false`, the dimension opts out of the project query timezone for display, grouping, and extracts - the raw warehouse value is rendered instead. Defaults to `true`. Has no effect unless a project query timezone is set. |