diff --git a/pages/common/pio-upgrade.md b/pages/common/pio-upgrade.md
new file mode 100644
index 0000000000..87d1a974e0
--- /dev/null
+++ b/pages/common/pio-upgrade.md
@@ -0,0 +1,12 @@
+# pio upgrade
+
+> Update PlatformIO to the latest version.
+> More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_upgrade.html>.
+
+- Update PlatformIO to the latest version:
+
+`pio upgrade`
+
+- Update PlatformIO to the latest development (unstable) version:
+
+`pio upgrade --dev`