diff --git a/pages/01.administrate/06.overview/11.update/upgrade.md b/pages/01.administrate/06.overview/11.update/upgrade.md
index 40ab28f2..8acb8a8a 100644
--- a/pages/01.administrate/06.overview/11.update/upgrade.md
+++ b/pages/01.administrate/06.overview/11.update/upgrade.md
@@ -24,11 +24,15 @@ Here are some example of corresponding command lines:
 yunohost tools update
 
 # Upgrade all system packages
-yunohost tools upgrade --system
+yunohost tools upgrade system
 
 # Upgrade all apps
-yunohost tools upgrade --apps
+yunohost tools upgrade apps
 
 # Upgrade a specific application
 yunohost app upgrade wordpress
 ```
+
+!! If you are upgrading from YunoHost below v4.2.2, `system` and `apps` were flags of the command. Add `--` before them:
+!! `yunohost tools upgrade --system`
+!! `yunohost tools upgrade --apps`