Documentation

Galleries

Galleries is your media library for photos and videos. Upload content, and AI automatically tags and organizes it so you can find and reuse assets easily. Use gallery items directly when creating p…

Galleries is your media library for photos and videos. Upload
content, and AI automatically tags and organizes it so you can
find and reuse assets easily. Use gallery items directly when
creating posts.

Click "Galleries" under Creator Pro in the sidebar, or navigate
to /galleries.

1. Click the upload button in the toolbar or header.
2. The Upload Modal opens with a multi-step form:
   - Gallery subject/title (what the photos/videos are of)
   - Description
   - Date
   - File selection (drag and drop or browse)
3. Select your files and start the upload.

You can upload individual files or entire folders.

Supported file types:
  Photos: JPG, JPEG, PNG, HEIC, GIF, WebP
  Videos: MP4, MOV

Uploads run in the background -- you can navigate to other
pages while files are uploading. A progress indicator appears
in the upload widget.

To add files to an existing gallery, use the "Add Files" or
"Add Folder" option, which reuses the gallery's subject, date,
and description.

After upload, AI automatically scans your media and assigns tags.

  - Photos are analyzed for content, objects, and context
  - Videos have frames extracted and analyzed
  - Tags appear as badges on each item (up to 3 shown)

While scanning is in progress, you will see "AI scanning..."
with an estimated time. The page polls every 4 seconds for
updates. A notification appears when scanning is complete.

If AI tagging fails for any items, a badge shows the failure
count. Click "Retry Scan" to re-queue those items.

Media is automatically grouped into galleries by subject and
date. Each gallery section shows:
  - Gallery name (subject + date)
  - Number of items
  - Scan status (if any items are pending)
  - Collapse/expand toggle

Ungrouped items (those without a subject or date) appear in an
"Untagged Media" section.

Toggle between two sort modes using the buttons in the header:
  - By Date: Newest galleries first (default)
  - By Name: Alphabetical order

1. Click the edit button on a gallery section header.
2. The Edit Tags Modal opens with fields for:
   - Subject/title
   - Date
3. Changes apply to ALL files in that gallery group.
4. Click Save to update.

Click any media thumbnail (when not in select mode) to open a
preview modal showing the full-size image or video with its
AI tags and metadata.

1. Click "Select" in the toolbar to enter selection mode.
2. Click items to select/deselect them (checkboxes appear on
   each card, and selected items show a blue border).
3. Use "Select All" to select everything at once.
4. Available batch actions:
   - Create Post: Opens the Post Wizard with selected media
     pre-attached
   - Download: Downloads all selected files

The status bar shows how many items are selected.

1. Select one or more media items in batch mode.
2. Click "Create Post."
3. The Post Wizard opens with your selected media already
   attached to the post.

You can also access gallery items from within the Post Wizard
by clicking "Browse Gallery" on the Content step.

Click the remove button on a gallery section header. A
confirmation dialog appears. Removing a gallery deletes the
entire group and all its items permanently.

Your media storage is metered by your plan tier. Check the
Usage page to see how much storage you have used and how much
remains. The Galleries page shows your total asset count and
any pending AI scans.

- Upload in bulk using folders to save time. The AI will tag
  everything automatically.
- Use descriptive gallery subjects to make searching easier
  later.
- If AI tagging fails on some items, try "Retry Scan" -- it
  usually resolves on the second attempt.
- Select multiple gallery items and click "Create Post" to
  quickly turn a shoot into content.
- Media uploads continue in the background, so you can keep
  working on other pages while files upload.

- 05-posts.txt (using gallery media in posts)
- 11-shotlists.txt (planning what to shoot)
- 16-usage-billing.txt (storage limits by plan)