diff --git a/editor/pages.mdx b/editor/pages.mdx
index 4bb67a373..44b9dd61c 100644
--- a/editor/pages.mdx
+++ b/editor/pages.mdx
@@ -8,6 +8,14 @@ keywords: ["editor", "content", "pages", "files", "create", "edit", "media", "im
 
 Browse pages in the **Navigation** tab of the left panel. Click a page to open it. Click the search icon or press <kbd>Cmd</kbd> + <kbd>K</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>K</kbd> (Windows) to search by filename or page content.
 
+What happens when you click a file depends on its type:
+
+- **Pages** (`.md`, `.mdx`) open in the editor for editing.
+- **Images and videos** open in a preview.
+- **`docs.json`** opens the [Configurations](/editor/configurations) panel instead of the raw file, so you can update site settings through the UI.
+- **Other text files** (like `.yml`, `.yaml`, `.json`, `.js`, `.jsx`, `.css`, `.txt`, and `.csv`) open in a read-only source view. To edit these files, update them in your code editor and push the changes to your repository.
+- **Binary and unsupported files** (like fonts, PDFs, or archives) are not clickable in the editor.
+
 <Note>
   The web editor treats API specification files (OpenAPI and AsyncAPI) as read-only. To update a spec file, edit it in your preferred code editor and push the changes to your documentation repository.
 </Note>