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

<ss:forms:fileupload />

Allows the user to upload a file.

Attributes

auto
bool
If set to true, files will automatically upload when added to the queue.
buttonIcon
string
The name or path for an icon to be used on the upload button. Supported names are "Upload", "Attachment", "Photo". Any other value will be interpreted as a path.
buttonText
string
The text to display inside the browse button. This text is rendered as HTML and may contain tags or HTML entities.
fileSizeLimit
string
The maximum number of files allowed to be uploaded. Set this option to "none" for no limit. This is the default.
focusOnLoad
bool
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.
height
mixed
Sets the height of the element. The default units are pixels. include the percentage symbol % to user percentage values.
id
string
(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.
multipleUpload
boolean
Enables multiple upload. Defaults false.
name
string
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.
onQueueComplete
string
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} }}
preloadSrc
string
The src of an existing image that should be preloaded into the FileUploader.
totalSizeLimit
string
The maximum upload size allowed in Bytes. 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 "none" for no limit. This is the default.
width
mixed
Sets the width of the element. The default units are pixels. include the percentage symbol % to user percentage values.

Examples

Simple File Upload Example

describes how to put a file upload element into a form

XML Code:

File upload and attach to email example

illistrates use of file upload in a form

XML Code: