# Gallery Reference

import { Image } from 'astro:assets';
import boardMenu from '../assets/gallery-board-menu.png';
import deleteBoard from '../assets/gallery-delete-board.png';
import imageMenu from '../assets/gallery-image-menu.png';
import gallerySettings from '../assets/gallery-settings.png';

This page describes the Gallery's menus, settings and shortcuts in detail. For an introduction to boards, searching, starring, uploading, and moving and deleting media, see [Organizing your media](/users-guide/gallery/introduction/).

## Managing boards

### The board menu

Hover over a board and click its **⋮** button, or right-click it, to open its menu:

<Image src={boardMenu} alt="The board menu with Save new results here, Download board, Rename board, Archive board and Delete board." width={420} />

* **Save new results here** — makes this the board that receives new results, marked with a crosshair-style icon in the board list, whichever board you are viewing; it also turns off **Follow the selected board**. On that board, the item is **Stop saving new results here**, which sends results back to the project's Inbox. Not offered for the Inbox itself, date boards, archived boards or boards you can only view. See [Choosing where new media goes](/users-guide/gallery/introduction/#choosing-where-new-media-goes).
* **Download Board** — downloads the board (see [below](#downloading-a-board)).
* **Rename board** — opens a dialog to change the name.
* **Access** — on a multi-user installation, who else can open the board: **Restricted**, **Everyone can view** or **Everyone can contribute**. Only the board's owner and administrators see it. See [Image Boards](/configuration/multi-user-mode/user-guide/#image-boards).
* **Move to…** — moves one of your own boards to the **Library**, into the open project, or into one of your other projects, which the menu lists under **Projects**; an administrator cannot move another person's boards. A board keeps its general access when it moves. You can also drag your board onto another group: the open project's, the **Library**, or one of your projects under **Other projects**. When the board's new project is hidden because **Other projects' boards** is off: if it was the selected board, the Gallery selects **Uncategorized**; if new results went to it, they go to the project's Inbox again.
* **Archive Board** / **Unarchive Board** — see [below](#archiving-a-board).
* **Delete Board** — see [below](#deleting-a-board).

On a board someone else owns, the menu starts with whose board it is and what you can do there, and it offers only what your role allows. A viewer can download the board; a contributor can also make it where new results go; an editor can also rename and archive it. Only the owner and administrators share or delete it, and only the owner moves it between the Library and their projects.

A project's **Inbox** is managed through its project: its menu has **Export project (.invk)** and **Download Board** instead, and renaming the project renames it. **Uncategorized** offers only **Save new results here** and **Download Board**, and date boards have no menu. If the board new results go to is deleted or archived, they go back to the project's Inbox. The same happens when you open a project after a board it used was deleted elsewhere — in another tab, or together with a project deleted from the Launchpad — or after you lost access to it: the project stops selecting it, saving new results to it and sending queued results to it.

### Archiving a board

Archiving hides a board you no longer use without deleting anything. Choose **Archive Board** from its menu, and the board disappears from the list. To see archived boards again, turn on **Archived boards** in the **Filter & sort boards** menu; they appear in their own **Archived** group, where **Unarchive Board** returns them to the list.

Archived boards are not included in [semantic search](/users-guide/gallery/introduction/#searching-by-content).

### Downloading a board

**Download Board** packages the board's images, from both its Media and Uploads tabs, into a `.zip` file. A notice appears while the archive is prepared, and the browser saves the file when it is ready. Videos are not included, and the menu item says how many will be left out, for example **Download Board (1 video omitted)**. To save a video, download it on its own from its menu.

### Deleting a board

Choose **Delete board** from the board's menu. The confirmation dialog says what the board holds, such as **98 images and 1 video**, and that deleting the board keeps it: its media moves to **Uncategorized** in the Library.

<Image src={deleteBoard} alt="The Delete board dialog with the media it holds, the Also permanently delete its items checkbox, and Cancel and Delete board buttons." width={500} />

* **Delete board** — removes the board and moves everything on it to **Uncategorized**. This is the default.
* **Also permanently delete its items** — tick it to delete the board's images and videos with it; the button then says how many, such as **Delete board and 99 items**. For a board with 50 items or more, you also type the board's name to confirm; once the check has answered, only the items that will actually be deleted count toward that. Ticking it also checks what still uses the board's media and lists it, as [deleting media](/users-guide/gallery/introduction/#deleting-media) does.

A deleted board cannot be restored, and deleted media cannot be undone. While media is being deleted, a notice says so; when it finishes, another says what was moved or deleted, and how much could not be deleted, if any.

Queued or running jobs that were sending results to the deleted board send them to **Uncategorized** instead. A project's Inbox cannot be deleted from the Gallery; delete the project instead, which also asks what to do with the project's other boards.

On a multi-user installation, only a board's owner or an administrator can delete it. When an owner deletes a shared board with its media, only their own media is deleted and other people's items move to Uncategorized; once the check of what uses the media has answered, the dialog names only the owner's items, such as **Also permanently delete your 2 items** and **Delete board and your 2 items**, and when none of the media is theirs it says that all of it moves to Uncategorized. An administrator's deletion removes everything. If some files cannot be removed, those items are kept in Uncategorized and a warning says how many.

## The media menu

Right-click an item, or several selected items, for its menu.

<Image src={imageMenu} alt="The context menu for an image: quick-action icons at the top, then Load workflow; under Continue working, Edit on Canvas, Upscale, Send to Video, Add to Canvas as… and New project from image; under Use image as, Use as reference image, Use as control and Use as prompt template; then Reuse from image, Select for compare, Generate PBR maps, Find in Gallery, Move to board and Delete image." width={420} />

For an image, the menu offers:

* **Quick actions** (the icons at the top) — open in a new tab, copy to the clipboard, download, open in the Preview, and star.
* **Load workflow** — open the workflow that made the image. Unavailable for images without one.
* **Continue working** — **Edit on Canvas** adds the image to the open project's canvas as an image layer and opens Canvas; **Upscale** sends it to the Upscale panel or upscales it at once; **Send to Video** uses it as the first frame in the Video panel; **Add to Canvas as…** adds it as a layer of the kind you choose; **New project from image** starts a new project whose canvas holds the image, sized to fit it.
* **Use image as** — **Use as reference image**, **Use as control** and **Use as prompt template**. Its **Reuse from image** submenu restores the settings that made the image: **Remix image**, **All settings**, **Use prompt**, **Use seed**, **Use size** and **Use CLIP skip**; see [Resetting to defaults](/users-guide/image-generation/generate-panel/#resetting-to-defaults). Settings an image does not record are unavailable.
* **Select for compare** — compare the image with the selected one; **Alt**-click (**Option**-click on macOS) on a thumbnail does the same.
* **Generate PBR maps** — queue normal, roughness and displacement maps of the image. They are saved to the board new results go to, or to the project's Inbox if you can't add to that board (Uncategorized when there is neither), and a notice reports when they are ready. The first run downloads the PBR models.
* **Find in Gallery** — select the image in its own board and scroll the grid to it, clearing a search or filter that would hide it.
* **Move to board** and **Delete image**.

A video's menu has the equivalent actions for video, including **Extend in Video**, **Use as reference video** and **Use as conditioning clip**. With several items selected, the menu offers the actions that apply to all of them, such as **Star selection**, **Download selection**, **Move to board** and **Delete selection**; for several images it also leads with **Add to Canvas as…** and **New project from images**.

Every image generated by InvokeAI also stores its generation metadata inside the file, so the prompt and settings travel with it when you download it.

## Gallery settings

The gear button in the Gallery header opens its settings:

<Image src={gallerySettings} alt="The Gallery settings popover with Image size, Thumbnails, Always show dimensions, Show in-progress section and Pagination." width={420} />

* **Image size** — the size of the thumbnails.
* **Thumbnails** — **Square** crops thumbnails to squares; **Aspect** shows each item's full shape.
* **Always show dimensions** — shows each item's width and height on its thumbnail, not only on hover.
* **Show in-progress section** — shows generations that are still running at the top of the grid.
* **Pagination** — **Infinite** scrolling or numbered **Pages**.

**All Gallery settings…** at the bottom opens the full settings. They also include **Middle-click opens media in a new tab** (under **Thumbnails**), off by default, which makes a middle click on an image or video tile open it in a new browser tab, and **Follow the selected board** (under **Destination**), off by default; turn it on to send new results to whichever board the Gallery shows, instead of the board named under **Saving to**. The full settings also include the sort order and the board visibility and sorting options from the [Filter & sort boards](/users-guide/gallery/introduction/#finding-filtering-and-sorting-boards) menu. All Gallery settings are saved with the project.

## Keyboard shortcuts

These work while the Gallery has focus:

| Shortcut | Action |
|---|---|
| Arrow keys | Move through the grid |
| **Enter** / double-click | Open the item in the Preview |
| **Shift**-click / **Ctrl**-click | Select a range / add or remove an item |
| **Ctrl+A** | Select everything loaded on the page |
| **.** (period) | Star or unstar the selection |
| **Delete** / **Backspace** | Delete the selection |
| **A** | Recall all of the selected image's settings |
| **R** | Remix the selected image: recall its settings, except the seed |
| **P** | Recall the selected image's prompts |
| **S** | Recall the selected image's seed |
| **D** | Use the selected image's size |
| **W** | Load the workflow saved with the selected image |

**A**, **R**, **P**, **S**, **D** and **W** also work while the Preview has focus.

Clearing the selection has no shortcut by default: click the **×** after the item's name in the Preview's title, or assign a key to **Clear gallery selection** in [Keyboard shortcuts](/users-guide/workbench/hotkeys/).

On macOS, use **Cmd** in place of **Ctrl**. See [Hotkeys](/users-guide/workbench/hotkeys/) for all shortcuts.