Skip to main content

GUI: Advanced Web File Upload

Description

Advanced Web File Upload uploads a file to a web application by directly targeting the file input element using locator criteria, without relying on the system file dialog. Use this step when the standard Web File Upload step does not work — for example, when the upload element is inside an iframe or when the page uses a custom file input that does not open a traditional browse dialog. It supports any file type (such as JPEG, DOCX, or PNG) up to 40 MB and works only with elements of type <input type='file'>. You can locate the target element using criteria, criteria value, element index, and iframe XPath.

Configurations

Field NameDescription
Step NameSpecify a unique name for the step.
The label identifies the step within the workflow and helps you reference it when debugging or linking steps.
Web Browser NameSelect a web browser from the list.
Ensure that the selected browser matches the one specified in the Start Browser step.
The field is mandatory.
CriteriaSpecify the criteria used to locate the target element on the web from which to upload the file.
For the list and description, see Criteria Table.
Supports variable or static values.
The field is mandatory.
Criteria ValueSelect or specify the relevant criteria value for the selected criteria.
Supports variable or static values.
The field is mandatory.
Element Index (Starts with 0)Specify the index of the element to locate on the web.
Supports variable or static values.
The field is mandatory.
Note: Specify First to locate the first element, or Last to locate the last element on the web.
Default value: 0.
Iframe IndicesSpecify the iframe indices value.
This ensures the target element is correctly identified within a nested frame structure.
You can provide comma-separated values (for example: 0,1,2).
Supports variable or static values.
Iframe XPathSpecify the unique XPath used to identify an iframe or frame relative to the top-level window.
Iframe XPath is a unique path that identifies the location of an <iframe> or <frame> relative to the top-level window.
It uses unique attributes such as id, name, or title when available (for example, iframe[@id='mainFrame']). If these attributes are not available, the frame is identified by its position among sibling frames (for example, iframe[2]).
For nested frames, each frame is joined in sequence to form the complete path.
Example:
if an element is inside iframe[@id='outer'], which contains frame[@name='middle'], and that frame contains iframe[@title='inner'],the generated path is:
iframe[@id='outer'];frame[@name='middle'];iframe[@title='inner'].
Supports static and variable values.
Frame IDSpecify the ID of the iframe that contains the target element. This ensures the action is performed in the correct iframe when multiple iframes are present on the page.
Default value: frameID.
Input File PathProvide a valid file path to upload the file.
Or
Click Browse to select and add the file path.
Notes:
- Supported only for elements of type file (for example, <input type='file'>).
- Maximum allowed file size is 40 MB.