invoke-ai · lstein · May 9, 2026 · May 9, 2026 · May 9, 2026 · May 10, 2026
diff --git a/docs/src/content/docs/features/Multi-User Mode/admin-guide.mdx b/docs/src/content/docs/features/Multi-User Mode/admin-guide.mdx
@@ -219,10 +219,13 @@ If no arguments are provided, the script will run in interactive mode.
 
 :::danger[Data Loss]
 Deleting a user removes the user record and cascades to their sessions, board shares, sent
-invitations, and per-user client state. It does **not** delete the boards, images, workflows, queue
-items, or style presets they created — those rows remain in the database, owned by a user_id that no
-longer exists, and will not appear in any user's gallery. Physical image files in `outputs/images`
-are also left in place until a gallery maintenance script is run to remove orphan images.
+invitations, and per-user client state. It does **not** delete the boards, images, videos,
+workflows, queue items, or style presets they created — those rows remain in the database, owned by
+a user_id that no longer exists, and will not appear in other (non-admin) users' galleries.
+Administrators keep gallery visibility of the orphaned images and videos and can review or delete
+them from there. Physical media files in `outputs/images` and `outputs/videos` are also left in
+place: orphan image files can be removed with a gallery maintenance script, while video files should
+be deleted through the gallery (which removes the file along with the record) or cleaned up manually.
 
 If you want their content gone as well, reassign or delete it before deleting the user. Back up the
 database first if recovery might be needed.

diff --git a/docs/src/content/docs/features/gallery.mdx b/docs/src/content/docs/features/gallery.mdx
@@ -1,14 +1,14 @@
 ---
 title: Gallery Panel
-description: Learn how to manage, organize, and use your generated images and assets with the Gallery Panel in InvokeAI.
+description: Learn how to manage, organize, and use your generated images, videos, and assets with the Gallery Panel in InvokeAI.
 lastUpdated: 2026-02-19
 sidebar:
   order: 1
 ---
 
 import { Card, CardGrid, Steps } from '@astrojs/starlight/components';
 
-The Gallery Panel is a fast way to review, find, and make use of images you've generated and loaded. The Gallery is divided into **Boards**. The *Uncategorized* board is always present, but you can create your own for better organization.
+The Gallery Panel is a fast way to review, find, and make use of images and videos you've generated and loaded. The Gallery is divided into **Boards**. The *Uncategorized* board is always present, but you can create your own for better organization. Boards are polymorphic — images and videos coexist on the same board and appear together in the gallery, sorted by creation time.
 
 ![Gallery Panel Overview](./assets/gallery.png)
 
@@ -51,10 +51,10 @@ Each board has a context menu accessible via right-click (or Ctrl+click).
 
 - **Auto-add to this Board:** If *Auto-Assign Board on Click* is disabled in settings, use this option to quickly set the selected board as the default destination for new images.
 - **Download Board:** Packages all images within the board into a `.zip` file. A notification link will be provided when the download is ready.
-- **Delete Board:** Permanently removes the board and all of its contents.
+- **Delete Board:** Permanently removes the board and all of its contents — both images **and** videos.
 
 :::danger
-Deleting a board will **permanently delete all images** contained within it. Proceed with caution!
+Deleting a board will **permanently delete all images and videos** contained within it. Proceed with caution!
 :::
 
 ### Image Storage Maintenance
@@ -134,6 +134,27 @@ Additionally, each image has a context menu (right-click or Ctrl+click) with pow
 
 ---
 
+## Videos in the Gallery
+
+Videos generated by InvokeAI (currently from the Wan 2.2 model family) appear alongside images in the same gallery view. Each video item displays a first-frame still as its thumbnail with a play badge in the corner; selecting it opens the video in the viewer where you can play it back inline.
+
+### Uploading Videos
+
+You can upload existing videos to a board via the standard drop-or-upload affordance. The upload pipeline accepts **MP4 files only**. Other containers (`.mov`, `.webm`, `.mkv`) are not transcoded on upload and are rejected at the API boundary — re-encode them to MP4 (for example with `ffmpeg -i input.mov -c:v libx264 output.mp4`) before uploading.
+
+### Video Context Menu
+
+Each video has a context menu with the same organization actions as images, plus video-appropriate variants:
+
+- **Open in New Tab / Download:** Opens or saves the raw MP4 file.
+- **Star Video:** Pins the video to the top of the gallery.
+- **Change Board:** Moves the video to a different board. *(Drag-and-drop onto board thumbnails also works.)*
+- **Delete Video:** Permanently deletes the video and its thumbnail.
+
+Videos count toward board contents: a board with two images and three videos shows five items in the polymorphic gallery list and reports both totals in its stats.
+
+---
+
 ## Summary
 
 This walkthrough covers the Gallery interface and Boards. For guidance on prompting and generation workflows, please refer to the [Prompting Guide](/concepts/prompting-guide/) and [AI Image Generation](/concepts/image-generation/).