Document Images and Media Manager

editor.mdx

@@ -112,6 +112,56 @@
 
 Press <kbd>Command</kbd> + <kbd>P</kbd> on macOS or <kbd>Ctrl</kbd> + <kbd>P</kbd> on Windows to search for files by name.
 
+### Manage images and media
+
+The visual editor includes an Images and Media view for browsing, previewing, and managing your image and video assets.
+
+To access the Images and Media view, select **Images and Media** from the sidebar navigation.
+
+<Frame>
+  <img
+    src="/images/editor/media-manager-light.png"
+    alt="Images and Media view in the visual editor"
+    className="block dark:hidden"
+  />
+
+  <img
+    src="/images/editor/media-manager-dark.png"
+    alt="Images and Media view in the visual editor"
+    className="hidden dark:block"
+  />
+</Frame>
+
+#### View modes
+
+The Images and Media view offers two ways to browse your assets:
+
+- **Tree view**: Browse assets organized by folder structure. This view is ideal for navigating large collections of media files.
+- **Gallery view**: Browse assets as thumbnails grouped by folder. This view is ideal for quickly identifying specific images or videos.
+
+Use the view toggle button in the toolbar to switch between tree and gallery views.
+
+#### Preview assets
+
+Select any image or video file to preview it in the right panel. The preview shows:
+
+- Full-size image or video player
+- File metadata including size and dimensions
+- File path for easy reference
+
+#### Configure assets
+
+Right-click on any file or folder to access configuration options:
+
+- **Copy path**: Copy the file path to your clipboard for use in your documentation
+- **Configure**: Open the configuration panel to view detailed metadata including file name, path, size, type, and dimensions
+
+The configuration panel also allows you to rename files and folders (coming soon) and delete assets (coming soon).
+
+#### Search assets
+
+Use the search bar to filter assets by name. The search works in both tree and gallery views, making it easy to find specific files in large media libraries.
+
 ### Create new pages
 
 Select the **Create a new file** icon in the file explorer sidebar.
@@ -269,7 +319,7 @@
   />
 </Frame>
 
 If you authorize Mintlify to your GitHub user, your commits will be signed as if you had made them yourself. If not, they will be signed by the Mintlify GitHub app.
 
 ### Pull requests and reviewing changes
 
@@ -296,7 +346,7 @@
     - Any specific areas that need review
   </Step>
   <Step title="Create and share">
     Select **Publish Pull Request**. The editor will provide a link to view your pull request.
 
     <Frame>
       <img

guides/media.mdx

@@ -23,3 +23,14 @@ Key guidelines:
 * **Videos** for abstract concepts and long workflows.
 
 Use media sparingly and intentionally to avoid unnecessary documentation debt. When done right, it enhances comprehension without adding maintenance burdens or accessibility barriers.
+
+## Managing media assets
+
+The visual editor includes an Images and Media view that helps you browse, preview, and manage your image and video assets. This feature makes it easier to:
+
+- **Find assets quickly**: Search and browse your media files in tree or gallery view
+- **Preview before using**: View full-size previews of images and videos
+- **Copy file paths**: Easily copy file paths to reference in your documentation
+- **View metadata**: Check file size, dimensions, and other properties
+
+To access the Images and Media view, open the [visual editor](/editor) and select **Images and Media** from the sidebar navigation. See the [Visual editor](/editor#manage-images-and-media) documentation for detailed information on using this feature.