diff --git a/pages/common/pio-boards.md b/pages/common/pio-boards.md
new file mode 100644
index 000000000..6fcc8ecf8
--- /dev/null
+++ b/pages/common/pio-boards.md
@@ -0,0 +1,12 @@
+# pio boards
+
+> List pre-configured embedded boards available in PlatformIO.
+> More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_boards.html>.
+
+- List all available boards:
+
+`pio boards`
+
+- List only boards from installed platforms:
+
+`pio boards --installed`