For the complete documentation index, see llms.txt. This page is also available as Markdown.
⚙️How to configure your upload settings
Set file types, max file size, and how uploads behave on the cart.
The Upload rules tab gives you full control over what customers can upload and how the upload field behaves. You can add as many rules as you need, and they fall into three groups: File requirements, Customer experience, and Pricing.
Please go to the "Upload Rules" tab while creating a field
Click "Add a rule" button to see the available options
File requirements
These rules control what kind of files customers can upload.
File size limit — Cap how large each upload can be. Useful for preventing oversized files that slow down processing.
Allowed file types — Restrict uploads to specific formats (e.g. JPG, PNG, PDF only). Helps you receive files in formats you can actually use.
File count limit— Allow multiple uploads with a minimum and maximum count. Use the minimum to make uploads required, and the maximum to cap how many files a customer can send.
Image dimensions — Set minimum and maximum pixel size for uploaded images. Ideal for print-quality requirements or blocking very small images.
Customer experience
These rules control how the upload field appears and behaves for the customer.
Image editor — Let customers crop their image before uploading. Supports free-form, square-only, circle-only, and aspect ratio cropping.
Image preview — Show the upload back to the customer so they can confirm the file before adding to cart.
Required upload— Make the upload mandatory. Customers must upload a file before they can add the product to cart.
Pricing
Customization fee— Add an extra charge when customers use the upload field. The fee is added to the cart via Cart Transform as either a separate add-on product or a bundled charge.
You can combine multiple rules on the same field. For example, you might require uploads (Required upload) + restrict to images only (Allowed file types) + cap files at 5 (File count limit) + charge a $5 fee (Customization fee).
Each rule has its own dedicated guide with full setup details. We recommend starting with one or two rules first to test the customer experience, then layering on more as needed.
