File Upload

Written By Floris de Vries

Last updated 2 days ago

The File Upload field allows customers to upload one or more files as part of their product configuration. This is commonly used for custom designs, print files, reference images, or supporting documents. Uploaded files can be required and may also influence pricing when referenced in later calculation steps.

Label

The Label defines the text displayed above the file upload field on the product page.
Use a clear and descriptive label so customers know what kind of file they need to upload.

Example:
Upload your design file

Key (unique ID)

The Key is a unique technical identifier for the file upload field.
It is used internally by the calculator and can be referenced in pricing logic or conditional steps.

Important rules:

  • Only lowercase letters are allowed

  • Numbers and underscores are supported

  • No spaces or special characters

Examples:
design_file
reference_upload

Required field

When Required field is enabled, the customer must upload at least one file before the product can be added to the cart.
Use this option when a file is mandatory to fulfill the order.

Upload mode

The Upload mode determines how files can be added by the customer.

  • Dropzone – Customers can drag and drop files or click to upload

  • (Other modes may be available depending on your configuration)

Choose the mode that best fits your product flow and user experience.

Allowed file types

You can restrict which file types customers are allowed to upload.
Only the selected file types will be accepted.

Supported file types include:

  • Images (JPG, PNG, WebP, GIF, SVG)

  • Documents (PDF, DOCX, XLSX, PPTX)

  • Video (MP4, MOV, AVI, WebM)

  • Audio (MP3, WAV)

Max total upload size

The Max total upload size defines the maximum combined file size that can be uploaded.

Example:
50 MB

If the total size exceeds this limit, the upload will be rejected.

Max files

The Max files setting defines how many files the customer can upload.

Example:
1 (single file upload)
5 (multiple files allowed)

Numeric value (float)

The Numeric value (float) can be used to apply a price change related to the file upload.
This value does not affect pricing by default, but can be referenced in later calculation steps to add fees such as:

  • Design handling costs

  • File processing fees

  • Manual review charges

💡 Tip:
Always clearly communicate accepted file types and size limits to avoid failed uploads and customer frustration.