Skip to content

Attachments

We provide support for uploading files in your forms or within our form builder. When files are uploaded, we conduct thorough checks for viruses and ensure compliance with MIME types. Initially, file uploading by validation is disabled. Refer to the documentation for instructions on how to enable file uploading and gain a comprehensive understanding of the process.

Files Validation

For detailed instructions on enabling file uploads and a comprehensive understanding of the process, please refer to the documentation. Note that if the file format or MIME type does not match the specified criteria, the file will be skipped during the uploading process. If you need additional file extensions, kindly get in touch with us to request the inclusion of new file extensions.

File Formats/MIME Types
ExtensionMIME Types
jpgimage/jpeg
image/pjpeg
jpegimage/jpeg
image/pjpeg
jpeimage/jpeg
jifimage/jpeg
image/pjpeg
jfifimage/jpeg
image/pjpeg
pngimage/png
gifimage/gif
tiffimage/tiff
image/x-tiff
tifimage/tiff
image/x-tiff
docapplication/doc
application/ms-doc
application/msword
application/vnd.openxmlformats-officedocument.wordprocessingml.document
docxapplication/doc
application/ms-doc
application/msword
application/vnd.openxmlformats-officedocument.wordprocessingml.document
pdfapplication/pdf
application/octet-stream
xlsapplication/excel
application/vnd.ms-excel
application/x-excel
application/x-msexcel
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
xlsxapplication/excel
application/vnd.ms-excel
application/x-excel
application/x-msexcel
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
pptapplication/mspowerpoint
application/powerpoint
application/vnd.ms-powerpoint
application/x-mspowerpoint
application/vnd.openxmlformats-officedocument.presentationml.presentation
pptxapplication/mspowerpoint
application/powerpoint
application/vnd.ms-powerpoint
application/x-mspowerpoint
application/vnd.openxmlformats-officedocument.presentationml.presentation
txttext/plain

Custom Form

Initially, file uploading is disabled. To enable it, navigate to your form settings and specify the maximum number of files your form will accept in the Maximum files per submission field and select file sizes for single and multiple file uploading.

Single File Upload

To configure your form to accept only a single file and disregard additional uploads, you must access the form settings page and specify the following settings. You have the flexibility to determine the maximum file size according to your preferences.

Requirements Form Setting:

  • Maximum files per submission - Enter the number 1 to allow a single file upload. While you have the option to enter more, it is not recommended for security reasons
  • Maximum single file size - You have the flexibility to set the file size according to your preferences; it's at your discretion

After configuring the settings, embed your HTML form on the desired site to enable the specified functionality.

html
<form action="https://api.headlessforms.cloud/api/v1/form/{FORM_TOKEN}" method="POST" enctype="multipart/form-data">
    <input type="file" name="attachments">
    <button>Submit</button>
</form>

WARNING

An important point to note is that your HTML form must have the attribute enctype="multipart/form-data" in order to accept file uploads.

Single File

This screenshot illustrates that the validation is set up to allow users to upload only a single file with a maximum size of 60 megabytes.

Multiple File Upload

To establish the form for uploading multiple files and tailor the necessary parameters, navigate to the dedicated form settings page. You have the flexibility to define the maximum file size based on your preferences, whether you are submitting a single file or multiple files.

Requirements Form Setting:

  • Maximum files per submission - Specify a number of files equal to or greater than 2 in this section
  • Maximum single file size - In this section, you have the autonomy to set the size for each of your files, applicable to all uploaded files
  • Maximum size of multiple files - In this section, you have the autonomy to individually set the size for all your files.

After configuring the settings, embed your HTML form on the desired site to enable the specified functionality.

html
<form action="https://api.headlessforms.cloud/api/v1/form/{FORM_TOKEN}" method="POST" enctype="multipart/form-data">
  <input type="file" name="attachments[]" multiple>
  <button>Submit</button>
</form>

WARNING

It's crucial to emphasize that your field must have a name flag ending with [], and your HTML form must include the attribute enctype="multipart/form-data" to facilitate the acceptance of file uploads.

Example: <input type="file" name="attachments[]" multiple>

Multiple File

This screenshot demonstrates that the validation is configured to permit users to upload up to three files, with each file having a maximum size of 100 megabytes. Additionally, the cumulative size for all files is restricted to 300 megabytes.

Form Builder

We also offer the capability to upload files for our form builder. Simply navigate to the form settings page, where you can easily incorporate a single-file or multiple-file upload area by dragging and dropping it onto your form settings.

Form Builder

When you drag a File field or Multiple file fields, the maximum number of uploaded files will be automatically adjusted in the form settings section. Configure the maximum file size in the form settings under the attachments section. Here, you have the option to specify the size for uploaded files, both for a Single File and Multiple Files. Additional information on File Validation and size determination can be found within this section.