Private media and upload limits
Fieldbook keeps uploaded images and videos in private storage and grants access through the application. Operators control file-size limits in Fieldbook and Supabase; authors upload through the editor.
Private storage
Fieldbook currently uses a private Supabase bucket named fieldbook-media. Keep it private even when browsing is public.
An Administrator or Contributor uploads through the editor. Fieldbook authorizes a storage path and verifies the completed upload before inserting a durable reference such as /api/media/<media-id>.png.
When a reader opens that reference, Fieldbook checks admission and whether published content uses the file. Authors can also access draft media. The application supplies a signed Storage URL lasting five minutes. Keep the durable Fieldbook reference in content; a signed URL expires.
Upload sizes and formats
Upload size depends on your storage provider and bucket settings. Fresh database setup does not add a Fieldbook bucket size cap. The optional FIELDBOOK_UPLOAD_MAX_BYTES environment variable can add an application limit; leave it unset to use Storage limits.
Provider and bucket settings remain under your control. See Supabase's upload-limit guidance (opens in a new tab) when changing them. Redeploy after changing an application environment variable.
Supported files are JPG, PNG, WebP, GIF, MP4 and WebM. Fieldbook stores video as uploaded and does not transcode unsupported codecs.
Files above 6 MiB use resumable uploads with 6 MiB chunks. Interrupted chunks can retry during the active transfer; after a page reload, choose the file again.
If an upload fails
Use the editor's message to identify the next check: account permissions, provider size limits, file type, connection or final upload verification. Retry through the editor. Making the bucket public will not fix the underlying configuration.
If media appears for an author but not a reader, check that the containing content is published and the reader can access the installation. Troubleshooting covers persistent failures.
Database backups do not contain uploaded file bytes. Choose any media recovery arrangements you need; Back up and restore explains the distinction.