diff --git a/docs/usage.rst b/docs/usage.rst
index 1d31d6e5f..ceea1cf5e 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -413,6 +413,15 @@ Examples
     command="borg serve --restrict-to-path /mnt/backup" ssh-rsa AAAAB3[...]
 
 
+.. include:: usage/upgrade.rst.inc
+
+Examples
+~~~~~~~~
+::
+
+    borg upgrade -v /mnt/backup
+
+
 Miscellaneous Help
 ------------------