diff --git a/pages/common/topgrade.md b/pages/common/topgrade.md
new file mode 100644
index 0000000000..4fdbe6cd3e
--- /dev/null
+++ b/pages/common/topgrade.md
@@ -0,0 +1,28 @@
+# topgrade
+
+> Update all applications on the system.
+> More at <https://github.com/r-darwish/topgrade>.
+
+- Run updates:
+
+`topgrade`
+
+- Say yes to all updates:
+
+`topgrade -y`
+
+- Cleanup temporary/old files:
+
+`topgrade -c`
+
+- Disable a certain update operation:
+
+`topgrade -disable {{operation}}`
+
+- Only perform a certain update operation:
+
+`topgrade --only {{operation}}`
+
+- Edit the config file with default editor:
+
+`topgrade --edit-config`