Finding assets
A growing library can hold thousands of images and video. The search box, the search-ranking setting, Find similar, and the filters work together to get you to the right asset fast. Everything here works in The Library, across both uploaded files and generated media.
Search the library
Section titled “Search the library”Type in the Search assets… box at the top of the Library. Results update as you type. Press / anywhere on the page to jump to the box, and press Esc to clear it.
What search matches depends on the ranking mode you pick — see below.
Choose how results rank
Section titled “Choose how results rank”Next to the search box is a ranking control that shows the current mode (the default reads Hybrid). Open it to switch between three ways of ordering results:
| Mode | What it does | Best for |
|---|---|---|
| Text | Ranks by the exact words in prompts, filenames, and tags, then by the details stored in the file itself (keywords, title, caption, creator, credit, camera and place name), then by the words in each asset’s AI caption | Finding an asset when you remember its name, a tag, or wording from the prompt, or what’s in the picture |
| Hybrid | Blends word matching with how an image looks — the default | Most searches, where you want both wording and visual match to count |
| Similar | Ranks by how an image looks, not by exact words | Describing a look you can’t name precisely (a color, a mood, a composition) |
A few things to know:
- Hybrid is the default and covers most searches. Switch only when you want to favor exact wording (Text) or favor look (Similar).
- Ranking applies once you type a search. With an empty box, the mode you pick is set aside for your next search.
- Your choice sticks for the session, so you can run several searches the same way.
Find similar
Section titled “Find similar”To find assets that look like one you’re already viewing, open any asset to its detail panel and click Find similar. The grid switches to a Similar assets view, ordered by how close each match looks to the one you started from, with the heading “Nearest matches to” that asset.
Find similar works on both uploaded and generated assets, which makes it useful for:
- De-duplicating a photo shoot — spot near-identical frames and keep the best one.
- Finding variants — gather every take on the same concept that’s scattered across the library.
- Building a set — pull together assets that share a look without hunting by name.
To leave the view and return to your normal grid, click Back to library.
Two messages can appear instead of matches:
- Still indexing — the asset was added very recently and isn’t ready for visual search yet. It’s usually ready within a few minutes; check back shortly.
- No similar assets — nothing else in your library looks close to this one yet. Add more assets and try again.
What gets indexed for files without a preview
Section titled “What gets indexed for files without a preview”Visual search normally works from the pixels of an image, its preview, or a video’s frames. Some originals, such as camera RAW, PSD, and some TIFFs, can’t be read directly. Until a preview has been made for one of these, Cauldron indexes a short description of the file instead. That description is sent to Google’s Gemini embedding model and contains only:
- The file format and file name
- The capture date (or upload date) and pixel dimensions, when known
- The folder path the file was imported from
- The brand it belongs to
- Up to 4 project names
- The camera, caption and up to 12 keywords stored in the file
- Up to 12 tags
The image itself isn’t sent for this step. If you edit the tags, brand, projects, or name, the description is rebuilt at the next indexing pass. Once a real preview exists, the file is indexed from its pixels like any other image.
Narrow with filters
Section titled “Narrow with filters”Filters cut a long result list down to what you need. Combine them with search, or use them on their own to browse.
- Brand — the brand selector in the top bar scopes the whole Library to one brand’s assets. See Brands.
- Project — pick a project in the rail’s Projects section to show only its assets.
Every other filter lives behind the Filter button beside the search bar (on a narrow screen it becomes a Filters sheet). Each filter you apply shows as a chip in the search bar; click its × to drop it.
| Filter | Options |
|---|---|
| Made by | Everyone, Me, or one teammate |
| Tag | One or more tags. Any matches assets with any selected tag; All requires every one |
| Status | Draft, In review, Approved, Changes requested, Retired |
| Source | Uploaded, Generated, Imported |
| Rating | 5★, 4★ and up, 3★ and up |
| Date | A from and to date |
| File type | Image or Video; PNG, JPEG, WebP, GIF |
| Orientation | Landscape, Portrait, Square |
| Collection | One or more collections |
| Location | Has location or No location, from the GPS or place name stored in the file |
| Shot date | Where the shot date came from: From the file’s tags, File date (the file’s modified time, which may be when it was copied), or Unknown |
| Camera | One or more cameras, as named in the file. Only cameras that appear in your library are listed |
Narrow by date
Section titled “Narrow by date”When you know roughly when something landed, the Library’s date controls are faster than search. The Date popover has a file-volume chart you can drag across to pick a range (with Last 7 days, Last 30 days, and This month presets), and the scrubber on the grid’s right edge jumps straight to any month. Date range combines with everything above, and it travels in the page link so you can share the exact slice. See The Library for the full tour.
You can also say when in words. Press ⌘K and type something like “shoe shots from last week”, “in March”, “yesterday”, “last 30 days”, “Q1 2026” or “2026-10”. Cauldron reads the date out of your search, shows only assets taken (or, without a capture date, added) in that window, and shows the window as a chip above the results, such as Last week. Click the chip’s × to search the same words across all dates. A date on its own, like “last week”, lists that window’s assets newest first. Words like “latest” or “recent” don’t set a window; they move newer matches up.
Weeks run Monday to Sunday, so “last week” is the full week before this one. A month without a year means the most recent one that has already started.
Saved views
Section titled “Saved views”If you rebuild the same filters every visit, save them as a view. Set up the search, filters, and dates you want, then click Save view at the end of the Views section in the Library rail. Give the view a name (Cauldron suggests one from your filters) and click Save view. The dialog tells you how many files match today; files that match later show up on their own.
Your saved views are listed under All files, Recently added, and Unfiled, each with its file count. Click one to bring its filters back. The view shows as a chip at the start of the search bar, and clicking the chip’s × clears the view and its filters. A view’s link works like any other Library link, so the back button and bookmarks behave the way you’d expect.
- Change a view. Adjust a filter while a view is on and the file count reads Edited. Click Update view to save the change into the view, or Save as new to keep the original and save a second one.
- Rename or delete. Use the ⋯ menu on the view’s row. Deleting a view never touches your files.
- Renames and merges are safe. A view remembers collections and tags themselves, not their names, so renaming a collection or merging a tag doesn’t break it.
- Views belong to a brand. The rail lists the views you saved on the brand you have open; switching brands clears the view on screen. With All brands open, you see the views you saved there.
A few things can’t be saved as a view: the Archive, and Find similar results. A new view starts out private to you.
Share and pin views
Section titled “Share and pin views”- Share with your brand. Creators, brand managers, and admins can pick Everyone on {Brand} under Who can see it when saving, or choose Share with {Brand} from a view’s ⋯ menu later. Make private takes it back. Everyone on the brand, guests included, can apply a shared view, and it only ever shows them files they’re allowed to see.
- Pin. Brand managers and admins can pin a shared view for everyone on the brand, from the save dialog or the ⋯ menu. Anyone except guests can also pin their own private views for themselves. A brand holds up to 5 pinned views, and each person up to 5 personal pins per brand.
- What’s listed first. The rail lists the brand’s pinned views first, then the other views shared with the brand, then your own. Hover a shared view to see who shared it; views the assistant made carry a sparkle.
- Who can change a shared view. Its author can rename, update, or delete it while they’re a creator on the brand; brand managers and admins can change anyone’s. Deleting a shared view removes it for everyone on the brand.
- Collections you can’t see. If a shared view filters by a collection you don’t have access to, its summary says “A collection you can’t see” instead of the name.
- Nothing matches. When a view finds no files, the grid shows its filters and an Edit filters button. If someone deletes a view you have open, your filters stay and a message tells you the view was deleted.
Smart collections
Section titled “Smart collections”A view can also show on the Collections page as a smart collection. Turn on Also show in Collections when you save it, or choose Also show in Collections from the view’s ⋯ menu. The card shows the view’s first four matches as its cover, a Smart label, and the current file count. Click it to open the Library with the view on.
- They fill themselves. You can’t drop files on a smart collection. To change what’s in it, change the files’ tags or status, or the view’s filters.
- Sharing freezes first. A share link always shows a fixed set of files, so Share on a smart collection copies its current matches into an ordinary collection named for the view and today’s date (for example “Hero shots · Oct 25”), then opens the share dialog for that. The smart collection keeps updating; the link doesn’t. Sharing again the same day reuses that collection.
- What gets frozen. Up to 2,000 files, or the top 200 for a view with a text search. Private drafts are left out, yours included.
- Share from the Library. With a saved view or any filters applied, a Share button sits next to Upload at the top of the Library. It freezes what’s on screen the same way, then opens the share dialog. It’s hidden on the unfiltered Library, in Archive and in Find similar, and for anyone who can’t create collections on the brand.
- Who sees them. A smart collection follows its view: a private view’s card shows only to you, a shared view’s card to everyone on the brand. A view saved under All brands shows under All brands. Remove from Collections in the card’s ⋯ menu takes it off the page without deleting the view.
For how to add tags, collections, and ratings so assets are findable later, see Uploading & organizing.