Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs - parameter dropdown labels (#75338)

Jeff Bruemmere6132a0ac684
diff --git a/docs/dashboards/filters.md b/docs/dashboards/filters.md
index 2a79d648c82..341563f46ab 100644
--- a/docs/dashboards/filters.md
+++ b/docs/dashboards/filters.md
@@ -115,7 +115,15 @@ Additionally, you can select an operator for the location filter:
### ID filter
-The ID filter provides a simple input box where you can type the ID of a user, order, and so on.
+The ID filter lets people filter on the ID of a user, order, and so on.
+
+You can select how people should filter on this column:
+
+- Dropdown list
+- Search box
+- Input box
+
+See [Set filter input type](#set-filter-input-type). To control which values appear in the dropdown or search box, see [Change a filter's selectable values](#change-a-filters-selectable-values).
You can give people the option to pick one value or multiple values.
@@ -241,7 +249,7 @@ To change the widget type:
1. When viewing a dashboard, click the **pencil** icon to **Edit the dashboard**.
2. Click on the filter or parameter you want to edit. A widget editing sidebar should pop up on the right side.
-3. In the sidebar, change the type of filter or parameter. Changing the widget type disconnects the widget from all cards. You'll need to reconnect to the relevant columns on each card for the new type. If you've changed the widget type by mistake and want to restore the widget and its connections to cards, you can exit dashboard edit mode without saving your changes.
+3. In the sidebar, change the type of filter or parameter. Changing the widget type disconnects the widget from all cards. You'll need to reconnect the widget to the relevant columns on each card for the new type. If you've changed the widget type by mistake and want to restore the widget and its connections to cards, you can exit dashboard edit mode without saving your changes.
### Change filter operator
@@ -305,11 +313,11 @@ A multi-select filter with the widget type [Dropdown list](#dropdown-list) or [S
3. Select "Dropdown list". If you don't see "Dropdown list" as an option, go to [Filter widgets: Dropdown list](#dropdown-list) for more info.
4. Click **Edit** (to the right of "Dropdown list") to specify where the values should come from:
- - From connected fields
- - From another model or question
- - Custom list
+ - **From connected fields:** Use the values from the field the filter is connected to.
+ - **From another model or question:** Pick a model or question (built with either the query builder or SQL), then set the **Column to supply the values** that the filter should pass along. You can also set a **Column to supply the labels** to show friendly labels in the dropdown while still filtering on the underlying values. For example, you could filter on product ID while showing the product's title so people can search for products by name or ID.
+ - **Custom list:** Enter each value on its own line.
- ![Selectable values](./images/selectable-values.png)
+![Selectable values](./images/selectable-values.png)
### Set a default filter value
diff --git a/docs/dashboards/images/selectable-values.png b/docs/dashboards/images/selectable-values.png
index ea42a7b321a..67bafddaf5e 100644
Binary files a/docs/dashboards/images/selectable-values.png and b/docs/dashboards/images/selectable-values.png differ
diff --git a/docs/questions/native-editor/filter-widgets.md b/docs/questions/native-editor/filter-widgets.md
index 2f5ae9497a6..04136354d4c 100644
--- a/docs/questions/native-editor/filter-widgets.md
+++ b/docs/questions/native-editor/filter-widgets.md
@@ -16,6 +16,8 @@ The kind of filter widget that Metabase displays when you create a field filter
Date fields will either have a simple date filter (for date variables) or a dynamic date picker (for field filters mapped to a date field).
+ID parameters also support all three widget types (input box, search box, and dropdown list), so you can power an ID filter with a dropdown or search box instead of a plain input box.
+
If you want to change the default filter widget for a particular field, you'll need to ask an admin to update that field in [the Table Metadata](../../data-modeling/metadata-editing.md) and set the desired "Filtering on this field" option.
For dropdown lists and search boxes, you can also customize values available in the list. See below.
@@ -58,11 +60,11 @@ When you add a dropdown menu or search box, you can tell Metabase which values p
2. Next to the option you chose, click **Edit**.
3. Metabase will pop up a modal where you can select **Where the values should come from**.
-You can choose:
+You can choose between:
-- **From connected fields**. If you selected the Field filter variable type, you'll also have the option to use the connected field.
-- **From another model or question**. If you select this option, you'll need to pick a model or question, then a field from that model or question that Metabase will use to supply the values for that dropdown or search box. For example, if you want the dropdown to list the different plans an account could be on, you could select an "Account" model you created, and select the field "Plan" to power that dropdown. The dropdown would then list all of the distinct plan options that appear in the "Plan" column in the Accounts model.
-- **Custom list**. Enter each item on a line. You can enter any string values you like.
+- **From connected fields:** If you selected the Field filter variable type, you'll also have the option to use the connected field.
+- **From another model or question:** Pick a model or question (built with either the query builder or SQL), then set the **Column to supply the values** that Metabase should filter on. You can also set a **Column to supply the labels** to display friendly labels in the dropdown while still filtering on the underlying values. For example, if you want the dropdown to list the different plans an account could be on, you could select an "Account" model you created and set the **Column to supply the values** to "Plan". Or, to filter on product IDs while showing product names, set the **Column to supply the values** to "ID" and the **Column to supply the labels** to "Title", so people see product names in the dropdown but the filter passes along the matching ID.
+- **Custom list:** Enter each item on a line. You can enter any string values you like.
You can also [change a dashboard filter's selectable values](../../dashboards/filters.md#change-a-filters-selectable-values).