From 686aaf85355bf9e1d69cec7c2aabfe43a70a6ccd Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 4 Jun 2026 10:23:39 +0000
Subject: [PATCH] docs: clarify subtotals are accurate for non-additive metrics

---
 references/chart-types/table.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/references/chart-types/table.mdx b/references/chart-types/table.mdx
index 53c84651..b8a95d86 100644
--- a/references/chart-types/table.mdx
+++ b/references/chart-types/table.mdx
@@ -207,6 +207,8 @@ You can add subtotals to your tables by selecting `Show subtotals` in the chart
 
 To use subtotals, you need to have at least 2 or more dimensions in your table visualization.
 
+Subtotals are calculated by running an additional query against your warehouse at each nesting level, so values are accurate for every metric type — including non-additive metrics like `count_distinct`, `average`, and ratio metrics. You won't see "average of averages" or inflated distinct counts in the subtotal rows.
+
 ### Expand subtotals by default
 
 When `Show subtotals` is enabled, you can also enable `Expand subtotals by default` to control how subtotal groups render when the chart first loads: