diff --git a/pages/01.administrate/06.overview/11.update/upgrade.md b/pages/01.administrate/06.overview/11.update/upgrade.md
index 02a0c705..8acb8a8a 100644
--- a/pages/01.administrate/06.overview/11.update/upgrade.md
+++ b/pages/01.administrate/06.overview/11.update/upgrade.md
@@ -32,3 +32,7 @@ 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`