Media upload

With the Media upload field type, the customer can upload a file on the product detail page – for example a logo to be printed, a template or a photo. The uploaded file is assigned to the line item and is available in the order.

Creating a "Media upload" field

1. Create a new field under Own/Additional Fields.

2. Select Media upload as the field type.

3. Configure the upload settings:

Setting	Description
Allowed file formats	Selection of the permitted file formats. Only visible if the format restriction is enabled globally (see below).
Max upload size in kB	Limits the file size of the upload.

Global settings for media upload

In the plugin configuration you will find additional, globally valid options in the Field type: Media upload section:

Setting	Key	Description
Show preview image	previewImage	Shows a preview image in the article after the upload.
Image width in px	imageWidth	Width of the preview image during media upload (default: 50).
Restrict file formats	fileTypeRestriction	If active, the permitted file formats can be restricted per field. If the option is disabled, all formats are allowed.

Behavior in the frontend

The customer selects a file in the upload field. If the preview is enabled and it is an image, a preview image is shown in the configured width. When adding to the cart, the file is taken over and assigned to the line item.

Tip: Restrict the permitted file formats and the maximum size sensibly to avoid faulty uploads and very large files. For print templates, pdf, png and jpg are common, for example.