Skip to content

Attach files and photos

Most entity detail pages have an Attachments tab where you can upload photos, scans, and supporting documents.

  1. Open the entity’s detail page.
  2. Switch to the Attachments tab.
  3. Click + Attachment (or drag and drop a file).
  4. Pick the file. Most formats work — PDF, JPG, PNG, DOCX, etc.
  5. Wait for upload (usually a few seconds).
  6. The file appears in the grid.

The first image attached to an entity is auto-flagged as the cover — it shows up at the top of the detail page header.

To change the cover:

  1. On the Attachments tab, hover over a different image.
  2. Click the cover icon to set it as the new cover.

To remove the cover entirely, just delete the image.

  • Hazards — photos of the hazard scene, the equipment in question, the controls in place.
  • Incidents — scene photos, injury photos (with consent), scanned witness statements, training records of those involved.
  • Actions — proof of completion (photo of the new mat, the installed extinguisher).
  • Inspections — section-by-section photos as evidence of the pass / fail call.
  • Roles / People / Training — diplomas, certificates, photos for the staff board.

Files are stored in Convex’s secure file storage, scoped to your organisation. Only members of your org can access them. Removing a member doesn’t remove their uploaded files — they stay on the entities they were attached to.

  • Per-file size: 100 MB.
  • No fixed limit on number of attachments per entity (within reason).
  • Supported types: anything with a MIME type. Some preview behaviour varies (images previewed inline; PDFs open in browser; office documents download).