How to Handle File Upload in Selenium: Fix and Best Practices

To handle file upload in Selenium, use sendKeys() on the file input element to set the file path directly. Avoid clicking the upload button to open the OS dialog, as Selenium cannot interact with native dialogs.

Why This Happens

Many beginners try to click the file upload button to open the system file dialog and then automate selecting the file. Selenium cannot control native OS dialogs, so this approach fails.

java

driver.findElement(By.id("uploadBtn")).click();
// Trying to interact with OS file dialog here - Selenium cannot handle this

Output

org.openqa.selenium.ElementNotInteractableException: Element not interactable or unable to handle OS file dialog

The Fix

Instead of clicking the upload button, locate the hidden file input element and use sendKeys() to set the file path. This bypasses the OS dialog and uploads the file directly.

java

WebElement uploadInput = driver.findElement(By.id("fileUpload"));
uploadInput.sendKeys("C:\\Users\\User\\Documents\\file.txt");

Output

File path set successfully, file ready for upload

Prevention

Always inspect the HTML to find the <input type='file'> element and use sendKeys() to upload files. Avoid trying to automate OS dialogs. Use absolute file paths and ensure the file exists before running tests.

• Use explicit waits to ensure the input is visible and enabled.
• Keep file paths configurable for different environments.
• Validate file upload success by checking page elements after upload.

Related Errors

Common errors include ElementNotInteractableException when trying to click hidden inputs, and InvalidArgumentException if the file path is incorrect or missing. Fix these by ensuring the input is visible and the file path is correct.

Key Takeaways

Use sendKeys() on the file input element to upload files in Selenium.

Never try to automate OS file dialogs; Selenium cannot control them.

Always use absolute file paths and verify the file exists before uploading.

Inspect the page to find the correct input element for file upload.

Validate upload success by checking page changes after sending the file.