ItemReturnForm Widget

The ItemReturnForm widget lets a signed-in shopper submit a return request for one or more items. Shoppers can look up an order, add individual product numbers, set return quantities and problem codes, provide notes, and attach permitted files.

After submission, the widget displays a confirmation and makes the return available through the shopper’s return-history workflow.

Add the widget to a page

<Control src="LoadWidgetControl.ascx"
    FileLocation="ItemReturnForm.html"
    RequireLogin="true"
    Options="allowedExtensionsForUpload: '.jpg, .jpeg, .png, .pdf',
        maxFileSize: 4500000,
        allowMultipleFiles: false" />

Widget options

Option	Default	Valid values or format	Effect
allowedExtensionsForUpload String	'.jpg, .jpeg, .png, .pdf'	File-extension list	Sets permitted attachment types.
maxFileSize Number	4500000	File size	Sets the attachment size limit.
displayRules Boolean	true	true, false	Shows or hides permitted attachment types and size.
selectButtonText String	'Click or Drop File here'	Text	Sets the attachment-control label.
allowMultipleFiles Boolean	false	true, false	Allows multiple attachments.
fileUploadPrefix String	''	Text	Adds a prefix to the uploaded file name.
fileUploadSuffix String	''	Text	Adds a suffix to the uploaded file name.
AddReturnNumberToFileName Boolean	true	true, false	Adds the return number to the uploaded file name.
strObscureFilename Boolean	false	true, false	Uses a randomly generated uploaded-file name.
popupText String	Not specified	Text	Sets the confirmation-popup text.
popupHeader String	Not specified	Text	Sets the confirmation-popup header.
popupButtonText String	Not specified	Text	Sets the confirmation-popup button text.
submitButtonText String	Not specified	Text	Sets the submit-button text.
salesOrderPlaceholder String	Not specified	Text	Sets the order-lookup placeholder text.

Validate return submission

1. Sign in with a shopper account that has eligible return items.
2. Look up an order, add an individual item, set quantities and problem codes, and enter notes.
3. Attach an allowed test file and verify unsupported or oversized files are rejected.
4. Submit the request and confirm the return is available in the shopper’s return-history workflow.