diff --git a/references/tables.mdx b/references/tables.mdx index 6529ea24..25788f4a 100644 --- a/references/tables.mdx +++ b/references/tables.mdx @@ -595,7 +595,9 @@ The order that the fields are listed in `default_show_underlying_values` is the Use `default_filters` to define filters on Dimensions that will be applied when no other user-defined filter on those Dimensions exists. Default filters will apply to tables on load and can be populated with a pre-determined value. Use them to suggest to users the kind of filters they might want to consider, or provide a default filtered view of a table that can be changed if needed. -An optional `required` flag can be added - in which case the filter _cannot_ be removed or modified. This can be particulalry useful if you have a large table and want to force users to filter on a partitioned date. +An optional `required` flag can be added, and if this flag is set to `required: true`, the filter for this field cannot be removed from the UI but users can still modify the operator and value to adjust how this filter is applied to the data. This ensures the filter is always applied in some form, while giving users flexibility to change the date range or other values. This can be particularly useful if you have a large table and want to force users to filter on a partitioned date. + +In contrast, when `required: false` (or omitted), the filter is pre-populated but fully editable — users can change the field, operator, value, or remove it entirely. Below you can see there is a default filter with the optional required flag, that will have show the last 14 days of data by default. @@ -652,9 +654,7 @@ Below you can see there is a default filter with the optional required flag, tha - When a filter has `required: true`, the filter is completely locked in the UI — the field, operator, and value cannot be modified, and the filter cannot be removed. It will always be applied exactly as defined in the model YAML. - - In contrast, when `required: false` (or omitted), the filter is pre-populated but fully editable — users can change the field, operator, value, or remove it entirely. + Note: Required filters are not a security feature. For secure data access control, use [user attributes](/references/user-attributes). ### If you have many filters in your list, they will be joined using `AND`