diff --git a/editor/pages.mdx b/editor/pages.mdx
index 3e6549c93..746f33a69 100644
--- a/editor/pages.mdx
+++ b/editor/pages.mdx
@@ -27,6 +27,10 @@ Browse your documentation pages in the **Navigation** tab of the left panel.
 
 Switch between visual and Markdown mode with the toggle in the toolbar. The web editor saves your changes when switching modes.
 
+<Note>
+  API specification files (OpenAPI and AsyncAPI) are read-only in the web editor. You can view their contents but cannot edit them directly. To update a spec file, edit it using your preferred code editor and push the changes to your documentation repository.
+</Note>
+
 <Frame>
   <img
     src="/images/editor/mode-toggle-light.png"