diff --git a/pages/common/pio-run.md b/pages/common/pio-run.md
new file mode 100644
index 0000000000..4c01eb8995
--- /dev/null
+++ b/pages/common/pio-run.md
@@ -0,0 +1,28 @@
+# pio run
+
+> Run PlatformIO project targets.
+> More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_run.html>.
+
+- List all available project targets:
+
+`pio run --list-targets`
+
+- List all available project targets of a specific environment:
+
+`pio run --list-targets --environment {{environment}}`
+
+- Run all targets:
+
+`pio run`
+
+- Run all targets of specified environments:
+
+`pio run --environment {{environment1}} --environment {{environment2}}`
+
+- Run specified targets:
+
+`pio run --target {{target1}} --target {{target2}}`
+
+- Run the targets of a specified configuration file:
+
+`pio run --project-conf {{path/to/platformio.ini}}`