ZenotiHelp

File upload β€” size parsing and description text

ZTZenoti Docs Team Updated October 26, 2026 5 min readGuide

The file upload component in the form builder enforces a configurable maximum file size and displays that limit as hint text below the file picker. This article explains how the size limit works, what guests and staff see when they open a form with a file upload field, and how image files are handled when uploaded.

Audience: Form administrators and front desk staff who configure or use forms containing file upload fields.


On this page


Before you begin

  • Your organization must have the form builder enabled and at least one form containing a file upload component.
  • To configure the maximum file size on a file upload component, you need access to the form builder.
  • File upload components are available only in forms built with the form builder (V3 forms). They are not available in forms built with the legacy form builder.
  • The file upload component is controlled by the file uploader organization setting. Confirm with your administrator that this setting is active for your organization before configuring file upload fields.

How the maximum file size is enforced

When a form includes a file upload field, the form builder reads the maximum file size value you configure on that component and converts it to bytes for enforcement at upload time.

You can enter the size in any of the following formats:

Format Example Interpreted as
Megabytes 25MB 25 megabytes
Kilobytes 512KB 512 kilobytes
Plain number 1024 1024 bytes

If the configured value is absent or cannot be parsed, the system defaults to 25 MB.

Important: The default of 25 MB applies automatically when the field is left blank or contains an unrecognized value. Verify the configured size before publishing a form to ensure guests are not blocked unexpectedly.

Worked example

You configure a file upload component with a maximum size of 10MB. A guest attempts to attach a 12 MB PDF. The system rejects the file and the guest sees an error. If you had left the maximum size field blank, the system would have used the 25 MB default and the same 12 MB file would have been accepted.

What hint text guests and staff see

The file upload component displays a hint below the file picker so guests and staff know the size limit before they attempt to upload. The hint text is generated automatically from the configured maximum size and the component type.

The wording differs depending on whether the component allows one file or multiple files:

Component type Hint text displayed
Single-file upload Max file size: {maxSize}
Multi-file upload Upload up to 10 files at a time. Max {maxSize} per file.

In both cases, {maxSize} is replaced with the human-readable value derived from your configuration (for example, 25MB or 512KB).

Note: The hint text is read-only and cannot be customized. It updates automatically when you change the maximum size value on the component.

How image files are displayed

When a guest or staff member uploads an image file, the form renderer treats it differently from other file types. Image files are displayed inline within the form rather than as a download link.

The following image file types are displayed inline:

File type Inline display Thumbnail generated
JPEG Yes Yes
PNG Yes Yes
GIF Yes Yes
BMP Yes No
WebP Yes Yes
HEIC Yes Yes

Note: BMP files are displayed inline but do not generate a thumbnail preview. All other supported image types generate a thumbnail.

Non-image file types (such as PDF or DOCX) are not displayed inline and appear as file attachments.

Tips

  • Use MB or KB suffixes when configuring the size limit. Entering a plain number is interpreted as bytes, which is rarely the intended limit. Use 25MB rather than 26214400 to reduce configuration errors.
  • Test the hint text after configuring. Open the form in preview to confirm the hint reads as expected before publishing. The hint updates immediately when you save changes to the component.
  • Use single-file upload for signature or consent attachments. When only one file is needed (for example, a signed consent scan), use the single-file component to prevent guests from attaching multiple unrelated files. The hint text for single-file components is simpler and less likely to cause confusion.
  • Account for HEIC files from iOS devices. Guests using iPhones typically produce HEIC images. HEIC is a supported inline type, but some older desktop browsers may not render HEIC thumbnails. If your guest base is primarily mobile, this is generally not an issue.

Troubleshooting

The hint text shows an unexpected size value.

The hint reflects whatever value is stored in the maximum file size field on the component. If the field contains an unrecognized string, the system silently defaults to 25 MB. Open the component settings in the form builder, clear the current value, and re-enter the limit using a recognized format such as 10MB or 512KB. Save and preview the form to confirm the hint updates.

A guest reports their file was rejected even though it appears small.

The size limit is enforced in bytes after parsing. If the configured value uses a plain number without a unit suffix, it is interpreted as bytes β€” not megabytes or kilobytes. For example, a configuration of 512 allows only 512 bytes, not 512 KB. Update the value to 512KB or the intended unit.

An uploaded BMP image does not show a thumbnail.

BMP files are displayed inline but thumbnail generation is not supported for BMP. This is expected behavior. If thumbnail generation is important for your workflow, ask guests to upload images in JPEG, PNG, GIF, WebP, or HEIC format instead.

The file upload component is not visible on the form.

File upload components require the form builder (V3 forms). If the form was built with the legacy form builder, file upload fields are not available. Additionally, the file uploader organization setting must be active. Contact your administrator to confirm both prerequisites are met.

The component defaults to 25 MB even though a value was entered.

The system falls back to the 25 MB default only when the configured value is absent or cannot be parsed. Check that the entered value matches a supported format: 25MB, 512KB, or a plain integer for bytes. Values such as 25 MB (with a space), 25mb (lowercase unit), or 25megabytes may not parse correctly depending on the form builder version in use. Use the formats shown in the configuration table above.

Was this article helpful?
Your feedback helps us improve our documentation.