Field Types
File Upload Field
File upload field for artwork, logos, or photos. Files are stored privately; admins download them from the order page.
When to use
- Custom artwork or logo uploads
- Photo personalisation
- PDF / design file attachments
The cover-design file upload field on the Personalized Leather Notebook demo product — captured on the live Smart Add-Ons demo store.
Settings reference
| Setting | Description |
|---|---|
| Field label | The title customers see above the upload button. |
| Maximum size (MB) | Largest file accepted. Default 5 MB, up to 50 MB. Your server’s PHP upload limit also applies. |
| Allowed file types | Images (jpg, png, gif, webp), Documents (pdf, doc, docx, xls, xlsx, csv, txt, rtf, zip), Images & documents, or Custom extensions (comma-separated, without dots). |
| Description | Optional help text shown below the field label on the product page. |
| Required field | Customers must upload a file before adding the product to cart. |
| Price type | Fixed amount, Percentage of product price, or Formula (Pro plans). The price is applied when a file is uploaded. See Pricing. |
| Quantity pricing | Per product quantity multiplies the price by the quantity ordered. Flat fee (once per line item) charges it once. |
| Min / Max product qty | Apply the add-on price only when the product quantity is in this range. Leave the maximum empty for no limit. |
| Conditional logic | Tick Enable conditional logic to show or hide this field based on another field in the same group. See Conditional logic. |
Order item meta
Upload references are stored with the order item. Admins download via a signed URL:
Field label: "Artwork"
Value: logo.png (private)
Price: +0.00Tips
- Full setup, storage, and troubleshooting: Secure file uploads guide.
Open full File Uploads guide →
How to add a file upload field
- In WordPress, go to Smart Add-Ons → Add-On Groups and open a group, or click + Add group.
- Click + Add field.
- Enter a Field label and set Field type to File upload.
- Under Upload settings, set the Maximum size (MB) and choose the Allowed file types.
- Leave the price at 0, or enter a Fixed price for a setup or artwork fee.
- Click Save group, then open a product the group applies to and check the field.
Example: logo upload for a printed notebook
A print shop adds a file upload field labelled “Your logo”, allows Images only and sets the maximum size to 10 MB. The customer chooses a file on the product page, sees its name, and adds the notebook to the cart. After the order is placed, the shop downloads the logo from the admin order screen. Files are kept in a private folder and are downloaded through a protected link, not a public URL.
File upload FAQ
Can a customer upload several files in one field?
Each file upload field accepts one file. To collect more, add another file upload field, for example “Front artwork” and “Back artwork”.
Can guests upload without an account?
Yes. Guests and logged-in customers can both upload, and the file stays attached to their cart until checkout.
Why is a file rejected?
Usually the type isn’t in the allowed list, or the file is larger than the field’s maximum size or your server’s PHP upload limit. See the file uploads guide.