Skip to main content
The shared Gallery picker lets you find and select a creator’s Vault media without leaving a fan chat, Mass Message, or Script editor. It combines OnlyFans media with AgencyKey captions, notes, and hashtags, and lets users with edit access update those details in place.

​
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
Type your query in the search box and the grid updates as you type.
A media item matches if any of its hashtags start with your query — so typing “summer” finds items tagged #summer2024, #summertime, and so on.
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.
If one Caption source is temporarily unavailable, results from the other source stay visible and the warning names the source that failed. Select Retry to retry only that source. A full load error also provides Retry.

​
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 usage filters combine with the active Type, list, date, and search mode. Publication follows the post state reported by OnlyFans. The Current subscriber filter is available 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; an empty first page does not prove that the whole Vault has no matching media.

​
Metadata overlays on thumbnails

Every thumbnail in the picker shows the same overlay you see on the main Vault page:
  • the Caption, or the internal Note when no caption is available;
  • Hashtags on a separate line.
The strip keeps each line compact. Rest the pointer on a media card for about half a second to open the full, untruncated Caption or Note and all Hashtags. Long text can be scrolled and selected inside the tooltip; keyboard focus on a card control exposes the same details. This means you can confirm you’ve selected the right media without opening the editor. 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.

​
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. 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

Click a thumbnail to select or deselect it — multiple selections are supported. 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 — click to open an enlarged image
  • Video — hover for a silent loop, or maximize it for sound and playback controls
  • Audio — click Listen to use the built-in player
When Gallery is opened from a fan chat, protected video or audio can open through the OnlyFans viewer inside the AgencyKey preview dialog. Use the full-video action for protected video or Listen for protected audio. If OnlyFans cannot play the item, its error remains visible. Outside a fan chat, Gallery can show an available still frame for protected video but cannot play protected video or audio. A ready protected audio item can still be selected and attached even when Listen is unavailable. The same audio player is available when you review saved attachments in Scripts and Scenarios. In the browser, audio declared above 128 MB is not opened; AgencyKey Desktop can stream large audio instead.
Opening a photo, video, or audio preview does not select it. Use the selection control separately when you want to attach the item.
Use the Refresh button in the toolbar if media was just uploaded and does not appear yet.

​
Next steps