Controls ss:ajax delayedload event region ss:data calendar column repeater table tree ss:forms captcha checkbox codeeditor combobox datepicker daterange dialogbox editbox fileupload fileuploadimage form hidden money officeuseregion option password paymentmethod radiobutton row searchbox selectlist signature slider spinbox submitbutton submitimage submitlink textarea timepicker ss:layout rotator stepper stepperpanel tablist tablistitem ss:logic dependency parse if else include template variable ss:navigation breadcrumbs item primary secondary ss:personalisation firstname fullname lastname other ss:regions content contentadditional security togglable ss:standard audio embed icon image label link script video ss:templates button column flexlayout header row section sociallinks styles teammember testimonial timeline timelineitem ss:thirdparty googlemap googlemapmarker

<ss:forms:fileuploadimage />

Allows the user to upload an image, with options for previewing existing images.


If set to true, files will automatically upload when added to the queue.
The text to display inside the browse button. This text is rendered as HTML and may contain tags or HTML entities.
The maximum upload size allowed in KB. This option also accepts a unit. If using a unit, the value must begin with a number and end in either KB, MB, or GB. Set this option to 0 for no limit.
If true, this control will attempt to focus itself after the page has loaded. Note that only one element may be focused on the page at a time. Default = false.
The height of the browse button in pixels.
(Required) Most form items need a unique id so that they can submit data to the server. No two form items may have the same id. For situations where multiple form items submit to the same field, see the name attribute. Id's that begin with contact_ will automatically save Contact information to the Contact database as long as the user has entered enough identifying information (ideally Name and Email). Check the Contact Fields page for correct field names.
Sets the name of the form item. Most of the time, the id attribute will suffice. However with form items that post multiple values into an array, each item will need to have the same name, followed by []. For example three controls with name="data[]", will all post into 'data'. Radio buttons belonging to the same group will have to share the same name.
A JavaScript callback triggered when all uploads have completed. _arrFileUploadSuccessFiles: {Array{ complete: {Boolean}, name: string, arrFileNames: {Array{String}}, // The file names as they have been stored in the // filesystem. type: string, size: int, uploading: {Boolean} }}
The maximum number of files that can be uploaded at once

Set to 0 for unlimited.
Sets the width of the element. The default units are pixels. include the percentage symbol % to user percentage values.


Simple Image File Upload Example

describes how to put a file upload Image element into a form

XML Code:

Run Example