diff --git a/references/chart-types/table.mdx b/references/chart-types/table.mdx
index 5e603463..40a9c512 100644
--- a/references/chart-types/table.mdx
+++ b/references/chart-types/table.mdx
@@ -277,6 +277,18 @@ When you add a new rule, you'll first need to pick which column should be highli
 
 You can set as many rules on a table as you want. If two or more rules disagree with each other, the rule that's on the bottom of your list of rules will win.
 
+### Choosing what gets colored
+
+For single-color rules, you can choose where the color is applied using the **Apply to** control:
+
+- **Cell** — fills the background of the matching cell (the default).
+- **Text** — colors the text of the matching cell instead of its background.
+- **Row** — fills the background of every cell in the row whenever the rule's column matches. Use this to highlight whole rows based on a single column's value, for example painting subtotal or total rows in a P&L by a row-type column. In pivot tables, the fill spans all column groups, including the leftmost label column.
+
+If a cell also matches its own **Cell** or **Text** rule, that rule wins for the cell — Cell rules paint over the row fill, and Text rules leave the row background continuous while recoloring the text.
+
+The **Row** option is only available for single-color rules (it's not offered for color ranges).
+
 ### Color ranges
 
 To use color ranges for your rules, select **Range** under **Conditional Formatting**. You can choose specific minimum and maximum values, or you can automatically set them based on the values in your results.