diff --git a/source/_integrations/threshold.markdown b/source/_integrations/threshold.markdown
index 10fd2092f39..28d12c9a9b0 100644
--- a/source/_integrations/threshold.markdown
+++ b/source/_integrations/threshold.markdown
@@ -76,6 +76,24 @@ name:
   default: Threshold
 {% endconfiguration %}
 
+## Matrix of state change behavior
+
+### Sensor value rising
+
+| Set           | Turns on when           | Turns off when          |
+| ------------- | ----------------------- | ----------------------- |
+| only upper    | sensor > (upper + hyst) | never                   |
+| only lower    | never                   | sensor > (lower + hyst) |
+| upper & lower | sensor > (lower + hyst) | sensor > (upper + hyst) |
+
+### Sensor value falling
+
+| Set           | Turns on when           | Turns off when          |
+| ------------- | ----------------------- | ----------------------- |
+| only upper    | never                   | sensor < (upper - hyst) |
+| only lower    | sensor < (lower - hyst) | never                   |
+| upper & lower | sensor < (upper - hyst) | sensor < (lower - hyst) |
+
 ## Examples
 
 ### Is the temperature rising or falling