From 5a6b2f75ac79122bf26f9a3f8a15d4e853fcdeea Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 4 May 2026 21:37:50 -0700 Subject: [PATCH 1/2] docs: add example rule for suppressing charts in Slack (#10812) * Document Slack chart suppression rule example Generated-By: mintlify-agent * Move Slack chart rule guidance to Slack integration page Generated-By: mintlify-agent --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs-mintlify/docs/integrations/slack.mdx | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs-mintlify/docs/integrations/slack.mdx b/docs-mintlify/docs/integrations/slack.mdx index 2a7af33a8043e..2da1bf09e9d48 100644 --- a/docs-mintlify/docs/integrations/slack.mdx +++ b/docs-mintlify/docs/integrations/slack.mdx @@ -59,6 +59,21 @@ get AI-powered answers grounded in your semantic layer — without leaving Slack Follow-up questions can be asked by replying in the same Slack thread, keeping the conversation contextual. +### Customizing responses with rules + +The agent is aware when it's responding in Slack, so you can use [rules][ref-rules] +to tailor its behavior on this surface. For example, to suppress charts in Slack +unless the user explicitly asks for one, add an `always` rule: + +```markdown + +--- +type: always +--- +When responding in Slack, do not include charts in the response unless the user +has explicitly asked for them. +``` + ### User matching Cube identifies Slack users by their email address. For the integration to work, @@ -88,3 +103,4 @@ Slack Agent is in active development. The following limitations apply: [ref-analytics-chat]: /docs/explore-analyze/analytics-chat [ref-notifications]: /docs/explore-analyze/notifications [ref-scheduled-refreshes]: /analytics/scheduled-refreshes +[ref-rules]: /admin/ai/rules From 0a7948ed581683cd94d1c1336c87b4156bdfa5ab Mon Sep 17 00:00:00 2001 From: Artyom Keydunov Date: Mon, 4 May 2026 21:41:16 -0700 Subject: [PATCH 2/2] docs: document user attribute defaults for dashboard filters (#10814) Expand the Filter widget's "Default values" section to cover the new user attribute default toggle that resolves the filter's initial value from the viewer's user attribute at load time. Co-authored-by: Cursor --- .../dashboards/widgets/controls.mdx | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/docs-mintlify/docs/explore-analyze/dashboards/widgets/controls.mdx b/docs-mintlify/docs/explore-analyze/dashboards/widgets/controls.mdx index 6878d40d8730e..7fe0298641a14 100644 --- a/docs-mintlify/docs/explore-analyze/dashboards/widgets/controls.mdx +++ b/docs-mintlify/docs/explore-analyze/dashboards/widgets/controls.mdx @@ -30,6 +30,44 @@ Filters can allow either a single value or multiple values. Configure this when You can set a default value that's applied when the dashboard loads. Defaults are useful for scoping the dashboard to "this quarter" or "the user's region" without requiring viewers to interact with the filter first. +There are two ways to set a default: + +- **Static default** — pick a value (or values) directly in the filter. Every viewer sees the same default. +- **User attribute default** — resolve the default from the viewer's [user attribute][ref-user-attributes] at load time, so each viewer sees their own personalized default. + +Static defaults are configured by interacting with the filter in the dashboard builder — the value you select is saved on the widget and applied to every viewer when the dashboard loads. + +#### User attribute default + +Use the **User attribute default** toggle in the filter's edit sidebar to pre-fill a filter from the viewer's [user attribute][ref-user-attributes]. When the dashboard loads, Cube looks up the attribute value for the current viewer and applies it as the filter's default. + +This is useful for scoping a dashboard to the viewer's own slice of the data — for example, defaulting a **Region** filter to the viewer's `region` attribute, or a **Sales rep** filter to their `email`. + +To configure it: + + + + In the dashboard builder, click the filter widget's settings menu and choose **Edit Filter**. + + + Scroll to the **User attribute default** switch and turn it on. + + + Select the [user attribute][ref-user-attributes] whose value should be used as the default. Only attributes defined in your account appear in the picker. + + + +How the attribute value is matched to the filter: + +| Attribute type | How it's applied | +|---|---| +| **String**, **Number** | Used as a single value. Works with single-value operators like `is` / `is not`, and is also accepted by multi-select filters as a one-item selection. | +| **String array**, **Number array** | Used as a list of values, one per array entry. Empty values are dropped. | + +Empty, `null`, or unresolvable attribute values are skipped — the filter falls back to whatever static default it has, or no default if none is set. + +The user attribute default only seeds the filter's *initial* value. Viewers can still change the filter unless its [visibility](#visibility) is set to **Disabled**, in which case the resolved attribute value is locked in for that viewer. Values passed via URL parameters also take precedence over user attribute defaults, so deep links continue to work. + ### Faceted filters When multiple filters target dimensions from the same semantic view, you can mark them as **faceted**. Faceted filters scope each other's value lists — selecting a value in one filter narrows the options shown in the others, so viewers only see combinations that exist in the data. @@ -96,3 +134,4 @@ Mappings are also configurable by AI agents when they build or edit a dashboard, [ref-workbooks]: /docs/explore-analyze/workbooks [ref-charts]: /docs/explore-analyze/dashboards/widgets/charts [ref-granularities]: /docs/data-modeling/dimensions +[ref-user-attributes]: /admin/users-and-permissions/user-attributes