diff --git a/docs.json b/docs.json
index bb57aae56..6b908f563 100644
--- a/docs.json
+++ b/docs.json
@@ -71,7 +71,8 @@
                       "editor/live-preview",
                       "editor/collaborate",
                       "editor/publish",
-                      "editor/keyboard-shortcuts"
+                      "editor/keyboard-shortcuts",
+                      "editor/troubleshooting"
                     ]
                   },
                   "installation",
diff --git a/editor/troubleshooting.mdx b/editor/troubleshooting.mdx
new file mode 100644
index 000000000..b22304abb
--- /dev/null
+++ b/editor/troubleshooting.mdx
@@ -0,0 +1,24 @@
+---
+title: "Troubleshooting the web editor"
+sidebarTitle: "Troubleshooting"
+description: "Solutions for common web editor issues."
+keywords: ["editor", "troubleshooting", "permissions", "write access", "github"]
+---
+
+## "You don't have write access to this repo"
+
+<Frame>
+  <img src="/images/editor/write-access-error.png" alt="Error message showing user doesn't have write access to the repository." />
+</Frame>
+
+This error appears when your authorized GitHub account doesn't have write access to the documentation repository, even if you have full permissions in the Mintlify dashboard.
+
+**Solutions:**
+
+1. **Get repository write access**: Ask your GitHub admin to grant your GitHub account write (push) access to the documentation repository.
+
+2. **Unauthorize your GitHub account**: Remove your GitHub authorization in your [account settings](https://dashboard.mintlify.com/settings/account). The Mintlify GitHub App will sign commits on your behalf instead.
+
+<Warning>
+  If you unauthorize your GitHub account, commits won't be attributed to your GitHub profile.
+</Warning>
diff --git a/images/editor/write-access-error.png b/images/editor/write-access-error.png
new file mode 100644
index 000000000..3770bb7bd
Binary files /dev/null and b/images/editor/write-access-error.png differ