Field modules

File upload

File upload manages selected files, uploaded asset ids, and the rendered summary output for File Input (Simple) File Upload fields.

For Upload Manager (Advanced) fields, see the upload-manager module.

Events

The `formie:field:file-upload:uploaded-assets-sync` event

Triggered after uploaded asset ids have been hydrated back into field state and summary output.

js

document.addEventListener('formie:field:file-upload:uploaded-assets-sync', (event) => {
  const { fileUpload, assets } = event.detail;

  if (fileUpload?.dataset.formieFieldHandle === 'attachments') {
    fileUpload.dataset.uploadedCount = String(assets.length);
  }
});

The shared module lifecycle also exposes scoped events such as formie:module:file-upload:after-setup.

Last updated: Jun 12, 2026, 7:48 PM