The Library
The Library is your studio’s digital asset manager — the system of record for every visual asset a brand owns. Uploaded photo shoots, logos, brand kits, finished deliverables, reference libraries, and the images and videos you generate all live here in one place. Uploads and brand assets are the heart of it; your AI generations are a first-class part of the collection, but a smaller slice.
Think of the Library as the place where assets are kept, organized, and approved over the long term. It is the one place to browse everything your studio has made or brought in — filter by Source to see only generated or only uploaded work.
Open it from Library in the sidebar.
How the screen is laid out
Section titled “How the screen is laid out”The Library has two working areas:
- The left rail is for navigating. It holds your views, projects, collections and most-used tags, with the Archive pinned at the bottom.
- The toolbar above your files is for refining. It holds search, filters and the View menu, which narrow down and arrange whatever the rail is showing.
Between them sit your files, newest first, loading more as you scroll. The Library opens in Mosaic, which shows every file at its real shape in neat rows instead of cropping it to a square. If you’ve picked Grid or List before, the Library remembers that and keeps it. See The View menu to switch.
While you’re in the Library or a collection, the main sidebar folds down to its icons so your files get the room. It opens again when you leave.
Navigating with the rail
Section titled “Navigating with the rail”The box at the top of the rail searches projects, collections and tags at once. Click a section heading (Views, Projects, Collections, Sites or Tags) to collapse that section.
This browser remembers how you left the rail:
- Resize it by dragging its right edge. Double-click the edge to put it back to the standard width. When the edge is focused, the arrow keys resize it too.
- Hide it with the button next to the search box. A thin edge stays behind; click its button to bring the rail back.
- Collapsed sections stay collapsed after you reload.
If you open the Assistant on a screen narrower than 1600 pixels, the rail tucks itself away to make room. It comes back when you close the Assistant. On wider screens everything fits side by side.
Three views sit at the top of the rail, each with a live count:
- All files — everything you can see.
- Recently added — assets added in the last few days.
- Unfiled — assets that aren’t in any collection yet. This is your filing backlog; the count is highlighted when there’s work to do.
Archive, pinned to the bottom of the rail, holds what’s been deleted. See The Archive.
Projects
Section titled “Projects”The Projects section lists your active projects, each with its sub-collections nested under it. Click a project or a sub-collection to show its assets. To start a project, click + next to the heading. Archived projects don’t appear here.
Collections
Section titled “Collections”The Collections section lists the active brand’s collections, nested the way you built them, each with a count of the assets it holds.
- Click a collection to open its page.
- Turn on Include sub-collections to roll up assets from its sub-collections too.
- To create a collection, click + next to the heading. Use the ⋯ menu on any collection to rename, move, share, add it to a project, or delete it.
- Drag assets onto a collection to file them.
Collection pages, the Collections page and every way to file work are covered in Collections and tags.
The rail shows the collections of the brand you’re working in. That brand sits at the top of the sidebar, with its logo: click it to switch brands, and the rail reloads to that brand’s collections. All brands shows in blue and is read-only; one click picks a brand to work in.
The Sites section lists the sites you manage for the active brand. A dot shows each site’s state: Live, Waiting for DNS or Unpublished. Click a site to open its publish settings, or use its menu to open it, copy the link, unpublish it or publish it again.
Collections on a live site show a small globe in the rail. Hover it to see which site.
Tags belong to a brand. The Tags section shows the active brand’s four most-used tags and how many assets carry each one. Click a tag to filter by it, and click it again to clear the filter. All tags opens the full list. Admins also get a Manage link, which opens the Tags page. See Collections and tags.
Uploading
Section titled “Uploading”Upload is the green button at the top right of the Library, beside the page title. Click it to pick files, or drag files anywhere onto the page to upload them.
Bringing in a whole folder is a separate flow: open the arrow next to Upload and choose A folder on this computer, or drag a folder onto the page. That opens a full-screen import that groups the shots into collections for you and hands them back for review. For supported file types, batch uploads, and the full import walkthrough, see Uploading and organizing.
SVG files upload here too, up to 4 MB each. Anything in an SVG that could run code, like scripts or links to other sites, is removed when it uploads. Folder imports, Dropbox and Pics.io skip SVG files, so upload those here.
Refining with the toolbar
Section titled “Refining with the toolbar”The toolbar narrows down whatever the rail is showing. Filters combine, and the results update as you go.
Search
Section titled “Search”Type in the search box to find assets by name, prompt, or tag, or by the details stored in the file: keywords, title, caption, creator, credit, camera or place name. Results lead with the closest matches. The hint in the box tells you what you’re searching: Search in this collection, Search in this view when filters are on, or Narrow these results after Find similar.
Every filter you apply shows as a chip inside the search bar. Click the × on a chip to remove that filter.
Filters
Section titled “Filters”The Filter button beside the search bar holds every filter in one panel, and shows a count when any are on. Changes apply as you pick. Clear all resets them, and Show N files closes the panel.
| Filter | What it does |
|---|---|
| Made by | Show everything, only your work, or one teammate’s |
| Tag | Show assets with the tags you pick. Choose Any to match any tag, or All to require every tag |
| Status | Filter by review status: Draft, In review, Approved, Changes requested, or Retired |
| Source | Filter by how the asset arrived: Uploaded, Generated, or Imported |
| Rating | Show 5★, 4★ and up, or 3★ and up |
| Date | Pick a from and to date |
| File type | Image or Video, and PNG, JPEG, WebP or GIF |
| Orientation | Landscape, Portrait, or Square |
| Collection | Show assets in the collections you pick |
| Product | Show photos linked to a product or a whole product group, or No product to find brand photos not linked to anything yet. See Products |
| Location | Has location shows files that carry a GPS position or a place name; No location shows the rest |
| Shot date | Where the shot date came from: From the file’s tags (the camera, the video file, an .xmp sidecar or the import source), File date (the file’s modified time), or Unknown |
| Camera | Show files shot on the cameras you pick. The list holds the cameras found in your library’s files |
| Sent | Sent or scheduled shows assets with a social post that went out or is waiting to go; Not sent yet shows the rest. A canceled post doesn’t count |
Saved views keep the product filter.
Below the search bar, a result line shows how many files match and what’s shaping them, such as “match 3 filters” or “in Summer 26”. The view controls sit at its right.
On a narrow screen, or with the Assistant open, the filters move into a Filters sheet with an Apply button.
The brand you’re viewing is set by the brand at the top of the sidebar, not the toolbar — so it stays consistent across the whole app. See Brands for how brands work.
For search tips and ways to track down a specific asset, see Finding assets.
The View menu
Section titled “The View menu”The View button holds everything about how your files are laid out, in one place:
- Grid, Mosaic or List. Grid lines files up in even tiles. Mosaic keeps each file’s own shape, so portrait, square and wide crops read at a glance without opening them. List shows one row per file.
- Thumbnail size — four sizes, from Small to Extra large. Your browser remembers the size you pick.
- Fill or Fit — fill the tile, or fit the whole file inside it.
- Names and status badges — names show under each tile; status badges spell out the status in a tile’s details instead of a small icon. They start on in Grid and off in Mosaic.
- Group by — None, Date, Collection or Status. Status groups follow the review flow: Draft, In review, Changes requested, Approved, Retired. When grouped by collection, a file in two collections shows under both, and files outside any collection gather under Not in a collection.
Your choice of view sticks on this device. In every view, tiles and rows work the same way: click to open, tick or shift-click to select, drag into a collection.
List view
Section titled “List view”List shows one row per asset with its name, type, dimensions and aspect ratio, file size, brand, creator, status and date, plus Tags, Collection and Made by columns. It’s the quickest way to tell the 16:9, 9:16 and 4:5 versions of a shot apart. When the window is narrow, the least useful columns drop out first.
Browsing by date
Section titled “Browsing by date”With Group by → Date in the View menu, your files sit under month headings, newest first, such as August 2026. Each heading counts every file in that month, not just the ones loaded so far.
A scrubber runs down the right edge of the Library, with years and a tick for each month. A bubble shows the month you’re looking at. Hover to preview a month, then click or drag to jump to it. If that month isn’t loaded yet, the Library starts from there, and a Back to newest button returns you to the top. On a phone, scroll as usual; the scrubber appears on wider screens. It also hides while you search by text or use Find similar.
Click the date chip, or Pick on the timeline in the Filter menu’s Date section, to open the Date popover:
- Uploaded / Captured — date files by when they were added, or by when they were shot: the camera date on photos and the recording date on videos. When a photo or video carries no shot date, Cauldron uses the date from its
.xmpsidecar, the service you imported from, or the file’s modified date. Files with none of these use their upload date. - Presets — All time, Last 7 days, Last 30 days, and This month.
- Chart — file volume over time. Drag across it to narrow your files to a date range.
- The footer shows the range and how many files it matches, with Clear to remove it.
Months and days follow UTC, so a file added late in the evening may fall in the next day or month.
A date range lives in the page link, so a teammate who opens your link sees the same slice.
Reading an asset card
Section titled “Reading an asset card”At rest, each card shows just the picture. Only three things sit on it: a play mark and duration on video, a lock on a file that is restricted right now, and a tick box while you’re selecting. Hover a card, or move to it with the keyboard, and its details fade in along the bottom: its name, status, rating, source, brand, products, creator, aspect ratio, dimensions, and badges like Private (a draft only its creator and the studio’s owners and admins can see) or Mature. Hover also shows the card’s menu and Find similar. On a phone or tablet, cards stay picture-only; tap one to see its details in the viewer. Cards are selectable: pick several to act on them together (see Working with several assets at once).
Opening an asset
Section titled “Opening an asset”Click any card to open it in the file viewer, which fills the window so the picture gets the room.
- A label in the top left names the set you’re walking through: the collection, your filters, or the brand.
- For images, click the picture to toggle between fit and zoom, scroll to zoom, and drag to pan.
- Use the on-screen arrows or your keyboard’s left and right arrow keys to move between assets.
- The tool row under the picture holds Use as input, Reframe, Upscale and Remove BG.
- The row at the top right holds Download, Share, the ⋯ menu for everything else, and the panel button, which shows and hides the details (I). With the Assistant open, the details open over the picture so it keeps its space.
- Press Esc or the close button to exit. You land back on the same tile, with the Library scrolled where you left it.
The next step
Section titled “The next step”Under the file’s name, the status line shows where the file is in review (hover it for what that means and who can act), and at most one button for what you can do next: Submit for review on a draft, Approve while it’s in review, or Resubmit when changes were requested. If the details are hidden and a step is waiting, the panel button shows a small dot.
Everything else is in the ⋯ menu: Request changes, Retire, Move back to draft, Publish, and approving your own draft without review where your brand allows it. For how review works, see Review.
Keyboard shortcuts
Section titled “Keyboard shortcuts”| Key | What it does |
|---|---|
| ← → | Previous or next file |
| Enter | Approve, while reviewing |
| R | Request changes, while reviewing |
| F2 | Rename the file |
| D | Download the original |
| ? | List every shortcut |
| Esc | Close the viewer |
Moving to another brand
Section titled “Moving to another brand”Click the brand chip at the top of an open asset to move it to another brand. If the brand doesn’t exist yet, pick New brand, type a name and press Enter. Cauldron creates the brand and moves the asset in one go.
Versions
Section titled “Versions”Open a generated image and every version made from it shows as v1, v2, v3 thumbnails at the top of the panel, for anyone who can edit files. The prompt behind the version you’re looking at shows under the thumbnails.
- Click a thumbnail to open that version.
- Type a change in Describe the next version (“more tomatoes”) to make a new version from the image on screen, right there in the viewer.
- Tick two versions and press Compare to see them side by side. Esc goes back.
Generated images, upscales, cutouts and reframes get a short name for what they show, like “Pink perfume bottle on blush backdrop”, instead of a string of letters and numbers. Names you set yourself are never changed, and neither are the names of files you upload or import.
To rename a file, press F2 or edit the name in the details. Press Suggest for three names written from what the picture shows. Pick one, then press Enter to keep it or Esc to cancel. Suggestions are free and never rename anything until you choose. You can also ask the Assistant what to call an image.
Downloading
Section titled “Downloading”The Download menu offers:
- A web copy of the image.
- Size — Original, the file exactly as it was uploaded, then Large (2048 px), Medium (1024 px) and Small (512 px). Each is the whole image scaled so its longest edge is that size, for a landscape or a portrait alike. A size is never enlarged, so sizes as big as the original or bigger aren’t offered. Resized copies download as WebP, or as PNG when the original is a PNG with transparency.
- Social crops — your brand’s Post, Portrait, Story and Landscape, each a center crop of the image.
An SVG opens in the viewer as itself, so it stays sharp however far you zoom, and Original downloads the .svg file. Its sizes and social crops are drawn from the vector art at the size you pick, so a small icon still gives a crisp 2048 px copy, and they download as PNG with transparency kept.
The web copy, the resized copies and the social crops carry the photographer’s credit and license in the file’s metadata.
Every download starts with its brand, then the file’s own name, like “Acme - hero shot.png”. Files without a name get a short code instead. Zips follow the same rule — “Acme - Library - 2026-10-23.zip”, or “Cauldron - …” when the files span several brands — and the files inside are named the same way.
The details panel
Section titled “The details panel”The details beside the picture have four tabs: Details, Metadata, Thread and History. Hover a section’s label for what it’s for.
Details is where you describe and organize a single asset, in this order:
- Description — notes for your team. Not published.
- Tags — add labels to describe the asset. The tag picker shows how many files carry each tag. Press Enter to add the highlighted tag, or type a new one to create it in the file’s brand. Tags power the toolbar’s Tag filter and search.
- Collections — Add to collection opens a checklist of the brand’s collections, nested the way the rail shows them, with file counts and a search that matches the full path. Tick a collection to add the file and untick it to take it out. Type a name that doesn’t exist and pick New collection to create it and file the asset there. Collection chips show their parent, like “Spring 2026 › Website hero”, with a × on hover to remove the file.
- Linked to — the products the photo is linked to, and the projects it’s in. Editors can link or remove a product, or accept a suggestion in one click (see Products). An asset joins a project when you file it in one of the project’s collections.
- Suggested — tags Cauldron thinks fit. Click one to add it.
- File, then Source or Recipe — where the file came from: an upload, an import, or the prompt and model that made it.
- Rights and Restricted at the bottom. While a file is restricted, a small lock shows beside its brand at the top of the details; click it to jump to the Restricted section.
Metadata holds what was read from the file and what Cauldron wrote about it:
- Camera and file data — details read from the file itself, like camera and lens. They can’t be edited here. Under Captured, a short note says where the shot date came from: the camera, the video file, an
.xmpsidecar, the service you imported from, or the file’s modified date. A modified date may be when the file was copied rather than when it was shot, so Cauldron replaces it if a better date turns up later. - What Cauldron sees — a short line saying what’s in the picture or video. Cauldron writes it for every asset. Search finds assets by the words in it, so “terracotta vase” turns up a photo named IMG_0042, and the Assistant and connected AI tools read it in search results to tell what a picture shows without opening it.
The file’s name and its rating sit at the top of the details, above the tabs. Rename it there, or press Suggest (see Names). Click a star to rate it 1 to 5, or the active star to clear it.
Along the bottom you’ll find:
- Find similar — show assets that look visually close to this one. Useful for spotting near-duplicate shots or finding more of the same style.
- Delete — move the asset to the Archive.
The Thread tab
Section titled “The Thread tab”Every asset has a Thread tab for discussing the work in place. Leave a note, ask a question, or @-mention a teammate right next to the asset. For replies, reactions, attachments, and notifications, see Threads and comments.
Working with several assets at once
Section titled “Working with several assets at once”Tick cards or shift-click to select several, and a bar appears with:
- Tag, Add to collection, Move to brand, Download, Send to… and Archive.
- A ⋯ menu at the end with Submit, Retire, Show to brand and Reframe. When every file you picked is waiting on your review, Approve and Request changes come first.
- Ask Assistant at the right end, which opens the Assistant with your selection attached.
Bulk download packages the selected assets into a single zip, named as described in Downloading.
You can also drag a selection onto a collection in the rail. You carry a stack with a count, and the collection you hover reads “Add 3 files to …” before you let go.
Private drafts
Section titled “Private drafts”New AI generations start private. So do forks, tool results made from a private draft, and the reference images you upload to generate from. A private draft is visible only to you and to your studio’s owners and admins. Teammates on the brand don’t see it in the Library, search, Find similar, the asset pickers, Activity, the brand’s home page, or the Assistant.
Uploads to the Library and imports (folder, Dropbox, pics.io) aren’t private. The brand’s team sees them as soon as they land.
A private draft stops being private when you share it on purpose:
- Share with the brand, from the asset’s detail panel, or Show to brand in the bulk bar’s ⋯ menu for several at once
- submit it for review
- add it to a collection or project
- include it in a share link
- publish it to the community
- send it to Shopify or another destination
Sharing is one-way: a shared asset never goes back to private. Only the creator or a studio owner or admin can share a private draft. If a teammate tries to file your draft into a collection or a share link, it’s left out and a message says how many were skipped and why.
The Archive
Section titled “The Archive”Deleting an asset doesn’t erase it. It moves to the brand’s Archive, in the Library rail. Right after a delete, Undo sits in the message for 15 seconds; after that, the asset waits in Library → Archive.
From the Archive you can:
- Restore — put the asset back exactly where it was, with its collections, tags, rating, brand, and review status.
- Delete permanently — remove the file for good. It tells you how much storage you get back first. This is the only way to remove a file from Cauldron.
Archived assets still count toward your storage, and the Archive’s header shows how much they use.
Retiring an asset is different: Retire is a review step that takes work out of circulation but leaves it in the Library. See Review.
Moving assets through review
Section titled “Moving assets through review”The Library is where assets are organized; approval happens through the review pipeline. Assets begin as Draft and move to In review, then to Approved or Changes requested. You can filter by any of these states with the toolbar’s Status filter to see where things stand.
For who can approve, how to submit, and what each status means, see Review.