big docs

Files

Files is your workspace's media store. Upload an image or file once, and it's available to send in automations and to use on your link pages. Open it from Files in the sidebar.

Upload and manage

  • Editors and above can upload and delete files.
  • Viewers see the list read-only.

Each file shows its name, type, and size. Deleting a file frees up the storage it used.

You can also upload from the CLI with big media:upload <file> and list files with big media (or big_media_list on the local MCP server). Uploading isn't available on either MCP server.

What you can upload

KindTypesLargest file
ImagesJPEG, PNG, WebP, GIF8 MiB
VideoMP4, MOV25 MiB
DocumentsPDF, DOCX, CSV, ZIP25 MiB

Anything else is refused. On the CLI the type comes from the file extension; pass --type <mime> for a file whose extension doesn't say.

What big does to an upload

Every upload is checked before it's usable, and a file only shows as ready once it passes:

  • The contents must match the type. A file whose first bytes don't look like the type it claims (a renamed .exe called photo.png, say) is refused.
  • Images are cleaned. big strips the metadata from every image — camera details, GPS location — and re-encodes it. JPEGs stay JPEG; PNG, WebP and GIF become WebP (an animated GIF stays animated). So a file's type and size can change after upload, and the cleaned size is what counts against your allowance. An image that decodes to an enormous pixel count is refused rather than processed.
  • PDFs with active content are refused. A PDF carrying JavaScript or auto-run actions can't be uploaded — re-export it as a flattened PDF.

Where a file can be used

  • In DMs — as media on a send-DM automation action (see below).
  • On a link page — as the avatar, in an image block, as a link button's thumbnail, or as the page background, where it can be an image, a GIF or a video (with an optional separate one for phones). See Blocks and Theme. A script or agent refers to a file by its id — the id in big media — and the field names are in the link page schema.
  • On a scheduled post — as the post's media. See Scheduling.

Deleting a file that's in use

Deleting is immediate and permanent, and big doesn't stop you deleting a file something still uses. What happens to the things that used it:

  • A link page stops showing it: an image block is left off the page, a link button loses its thumbnail, the avatar disappears, and a background falls back to the default. The page's next save or publish is refused until you remove or replace the reference, so pick a new file in the editor.
  • A scheduled post keeps its slot but loses that file.

Check where a file is used before deleting it, especially on a published link page.

Storage allowance

Every plan includes a storage allowance, and your uploads count against it:

  • teeny — 250 MiB
  • tiny — 5 GiB
  • big — 25 GiB
  • bigger — 100 GiB

When you're out of space, new uploads are blocked until you delete something or upgrade. See Plans for the full comparison.

Using a file in a message

If you use big's Instagram DM features, uploaded files can be attached to the messages big sends: add one as media on a send-DM automation action. Attaching a file to a reply you type by hand is not available — manual replying is coming soon, so big inbox send --media <assetId> is refused too.

Files | itsjustbig