Opening the picker
Open the shared Gallery with:- Add Media From Vault in the composer of an open OnlyFans fan chat;
- Add media in the CRM Mass Message creator;
- Add media in the CRM Script or Scenario editor;
- Add media in the Scripts editor available inside the OnlyFans workspace.
In a fan chat, the Gallery belongs to that chat session. Changing the chat, creator, or access while it is open closes it without adding the pending selection.
Layout
On regular-width screens, the compact modal has a two-column layout that mirrors the Vault page:
The list and media areas scroll independently, so the controls and confirmation buttons stay visible. On a narrow screen, the lists move into a dropdown above the grid instead of taking a permanent column.
The toolbar keeps search, filters, sorting, date and refresh controls together. Use the two grid buttons to switch between Compact previews and Large previews without clearing your selection. Category rows show a total media count; hover a category to see its Image, Video, GIF and Audio breakdown.
Searching for media
Use the three-way search toggle above the grid to pick what you’re searching through:- Caption — combines matching captions from OnlyFans and AgencyKey, then removes duplicates
- Note — matches internal AgencyKey notes stored on the media
- Hashtag — matches AgencyKey hashtags attached to the media
All three modes search the creator’s Vault and then respect the active Type, selected list, and Date filters. During a metadata search, media sorting and sort direction are hidden because AgencyKey cannot guarantee one order across the OnlyFans and AgencyKey sources. Results load one page at a time: select Show more for the next page, because scrolling alone does not load it.
Filtering
Above the grid:
The left column also has a list-sort dropdown so you can order categories by Default, Name, or Media count.
The inline usage filters combine with the active Type, list, date, and search mode. Select All to clear both usage filters, or select an active Yes or No again to clear only that filter. Posts follows the publication state reported by OnlyFans. Sent appears only when Gallery is opened from a specific fan chat and checks that fan’s delivery history. A failed history check shows Retry instead of treating an unknown item as not sent.
Because usage filtering is applied while Vault pages load, Gallery can fetch one extra page automatically when the first page contains no matches. If more pages may still contain matches, select Continue search. One selection checks up to three more pages in sequence and stops early after finding eight matches; select it again when it remains available. An empty first page does not prove that the whole Vault has no matching media.
Metadata overlays on thumbnails
Every card in the picker can show:- the Caption, or the internal Note when no caption is available;
- Hashtags on a separate line;
- the media date and post or story markers when applicable;
- in a fan chat, whether the media was sent for free, purchased, or remains unpaid, with the available send date;
- OnlyFans likes, total Tips, and Buyers when those totals are available.
Editing metadata in the Gallery
If your role can edit the selected creator’s Vault, hover a card and select the pencil. The editor lets you change the Caption and Note and select Hashtags without closing the Gallery. AgencyKey first loads the latest saved values; editing and Save remain locked until that baseline is ready. A successful save updates the card immediately. If current metadata cannot be loaded or a save fails, keep the editor open and use the displayed recovery state instead of re-entering the same changes in another window.Send history
When message-history access is available, a card with recorded personal sends shows a compact history icon + count chip. The count includes revoked sends. Rest the pointer on the chip or focus it to see Sends: N and either the latest Last non-revoked date or All sends revoked. A confirmed zero or unavailable summary leaves the card unlabelled instead of showing a zero or an unknown state. The media date and available history, Likes, Tips, and Buyers counters share one compact row below the preview. On a narrow card, the counters wrap together below the date. Select the history chip to open Send history and review the creator, fan, exact send time, available team member, free or PPV status, revoked state, Script, and message text. A known Script uses its current name, while a deleted Script is labelled separately. Missing fan details, Script name, price, or message text are shown as unavailable instead of being guessed; a hidden sender is labelled Agency employee. This history does not include mass mailings or sends made outside AgencyKey. No send data or No sends recorded since [date] means no matching personal send exists in the available coverage; it does not prove the media was never sent by another method. The dialog shows its coverage start and warns when the history may be incomplete. When Gallery is open from a chat, Copy text to message places that send’s text in the composer. If the composer already contains text, AgencyKey asks before replacing it. Existing attachments, price, and schedule are left unchanged.Permissions and creator scope
Opening and searching this Gallery requires View list access for the selected creator through either Automation → Vault or Creators → OnlyFans Manager → Vault. The permission’s data scope must include that creator. In a chat, Gallery also refuses to open when OnlyFans reports that the creator account cannot send uploaded media. The pencil editor and category-list sorting require the corresponding Vault Edit access. Send history also requires permission to view that creator’s messages. Without edit access, you can still browse and select media allowed by your view scope. AgencyKey does not grant access while the creator relationship is unresolved; a recoverable access or loading error provides a retry instead.Selecting media
Use the checkbox in the top-right corner of a card to select or deselect it — multiple selections are supported. Clicking the media itself opens its viewer and does not change the selection. Media that is still processing or unavailable stays visible but cannot be selected. In a chat, the picker adds to the current draft: existing attachments remain in the draft, Vault items already attached appear selected and cannot be removed from Gallery, duplicate Vault items are skipped, and the total attachment limit is 40. The footer shows the total selected count and the confirmation button as Add N. Cancel, Escape, the close button, or a click outside the dialog discards only the pending Gallery selection. The composer remains locked while Gallery is open and confirms the media and any required release-form tags; if validation fails, the dialog stays open so you can refresh and retry without receiving a partial selection. In Mass Messages and Scripts, the selected items appear in the form as thumbnail previews when you close the picker.Previewing media
Preview an item without changing the current selection:- Photo — hover the center preview control for a quick look, or click the media for the full viewer
- Video or GIF — hover the center play control for a quick preview with sound, or click for the full viewer and playback controls
- Audio — hover its play control for a quick listen, or click the media for the full player
Opening a photo, video, or audio preview does not select it. Use the selection control separately when you want to attach the item.
Next steps
- Preview in OnlyFans chat — Metadata shown on vault media while you work in OnlyFans
- Captions, hashtags and metadata — Making sure each item is labelled for fast search