diff --git a/flaky-tests/detection/failure-count-monitor.md b/flaky-tests/detection/failure-count-monitor.md
index db6ef251..7d025cf2 100644
--- a/flaky-tests/detection/failure-count-monitor.md
+++ b/flaky-tests/detection/failure-count-monitor.md
@@ -79,7 +79,7 @@ Branch patterns work the same way as [failure rate monitor branch patterns](fail
 
 ### Action
 
-What happens when the monitor activates on a test. You pick the action at creation and can switch it at any time.
+What happens when the monitor activates on a test. You pick the action at creation and can change both the action type and the detection type (Flaky or Broken) at any time. If the monitor is active on any tests when you switch the detection type, those tests are re-evaluated immediately with the new classification.
 
 #### Classify test status (default)
 
diff --git a/flaky-tests/detection/failure-rate-monitor.md b/flaky-tests/detection/failure-rate-monitor.md
index 87e5bb65..df50e659 100644
--- a/flaky-tests/detection/failure-rate-monitor.md
+++ b/flaky-tests/detection/failure-rate-monitor.md
@@ -150,7 +150,7 @@ each pattern. -->
 
 ### Action
 
-What happens when the monitor activates on a test. You pick the action at creation and can switch it at any time.
+What happens when the monitor activates on a test. You pick the action at creation and can change both the action type and the detection type (Flaky or Broken) at any time. If the monitor is active on any tests when you switch the detection type, those tests are re-evaluated immediately with the new classification.
 
 #### Classify test status (default)