diff --git a/docs/mint.json b/docs/mint.json
index ab1011276..6a5e75c76 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -463,6 +463,7 @@
         "v3/upgrading-from-v2",
         "v3/changelog",
         "v3/feature-matrix",
+        "v3/known-issues",
         "v3/limits"
       ]
     },
diff --git a/docs/v3/known-issues.mdx b/docs/v3/known-issues.mdx
new file mode 100644
index 000000000..6ca151a9d
--- /dev/null
+++ b/docs/v3/known-issues.mdx
@@ -0,0 +1,12 @@
+---
+title: "Known issues"
+description: "Please let us know if you encounter an issue not on this list."
+---
+
+#### `pnpm` is not currently supported
+
+By default, pnpm has a more complicated package structure than npm. If you see this error when running the CLI then you're experiencing this bug:
+
+```bash
+✘ [ERROR] Could not resolve "@trigger.dev/core/v3"
+```