diff --git a/docs/cli/upgrade.md b/docs/cli/upgrade.md
index 13911e568c..35720ce110 100644
--- a/docs/cli/upgrade.md
+++ b/docs/cli/upgrade.md
@@ -53,9 +53,8 @@ Only upgrade to versions released before this date
 Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".
 This can be useful for reproducibility or security purposes.
 
-In "soft" mode (default), this only affects fuzzy version matches like "20" or "latest".
+This only affects fuzzy version matches like "20" or "latest".
 Explicitly pinned versions like "22.5.0" are not filtered.
-Use `install_before_mode = "hard"` setting to filter all versions strictly.
 
 ### `--raw`
 
diff --git a/man/man1/mise.1 b/man/man1/mise.1
index 723b60c36d..b3ccf490e6 100644
--- a/man/man1/mise.1
+++ b/man/man1/mise.1
@@ -2706,9 +2706,8 @@ Only upgrade to versions released before this date
 Supports absolute dates like "2024\-06\-01" and relative durations like "90d" or "1y".
 This can be useful for reproducibility or security purposes.
 
-In "soft" mode (default), this only affects fuzzy version matches like "20" or "latest".
+This only affects fuzzy version matches like "20" or "latest".
 Explicitly pinned versions like "22.5.0" are not filtered.
-Use `install_before_mode = "hard"` setting to filter all versions strictly.
 .TP
 \fB\-\-raw\fR
 Directly pipe stdin/stdout/stderr from plugin to user Sets \-\-jobs=1
diff --git a/mise.usage.kdl b/mise.usage.kdl
index 6ce9a692f0..57098cada8 100644
--- a/mise.usage.kdl
+++ b/mise.usage.kdl
@@ -1075,7 +1075,7 @@ cmd upgrade help="Upgrades outdated tools" {
     }
     flag "-n --dry-run" help="Just print what would be done, don't actually do it"
     flag --before help="Only upgrade to versions released before this date" {
-        long_help "Only upgrade to versions released before this date\n\nSupports absolute dates like \"2024-06-01\" and relative durations like \"90d\" or \"1y\".\nThis can be useful for reproducibility or security purposes.\n\nIn \"soft\" mode (default), this only affects fuzzy version matches like \"20\" or \"latest\".\nExplicitly pinned versions like \"22.5.0\" are not filtered.\nUse `install_before_mode = \"hard\"` setting to filter all versions strictly."
+        long_help "Only upgrade to versions released before this date\n\nSupports absolute dates like \"2024-06-01\" and relative durations like \"90d\" or \"1y\".\nThis can be useful for reproducibility or security purposes.\n\nThis only affects fuzzy version matches like \"20\" or \"latest\".\nExplicitly pinned versions like \"22.5.0\" are not filtered."
         arg <BEFORE>
     }
     flag --raw help="Directly pipe stdin/stdout/stderr from plugin to user Sets --jobs=1"
diff --git a/src/cli/upgrade.rs b/src/cli/upgrade.rs
index 2ae46babd6..87090e53c3 100644
--- a/src/cli/upgrade.rs
+++ b/src/cli/upgrade.rs
@@ -59,9 +59,8 @@ pub struct Upgrade {
     /// Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".
     /// This can be useful for reproducibility or security purposes.
     ///
-    /// In "soft" mode (default), this only affects fuzzy version matches like "20" or "latest".
+    /// This only affects fuzzy version matches like "20" or "latest".
     /// Explicitly pinned versions like "22.5.0" are not filtered.
-    /// Use `install_before_mode = "hard"` setting to filter all versions strictly.
     #[clap(long, verbatim_doc_comment)]
     before: Option<String>,