Troubleshooting browser drivers

This article describes how to troubleshoot browser drivers.

Help CentreTroubleshooting & FAQ

Sometimes your bot may fail to open a browser or interact with a web page. This usually happens when the browser version and the driver version don’t match. This guide will help you fix it quickly.

Note: The browser version should be the same or newer than the driver version. In other words: browser version ≥ driver version.


Common Error Messages You May See

  • “The element was not found.”
  • “Browser version #.## does not match driver version #.##”
  • “SessionNotCreatedException”
  • “NoSuchDriverException”

Step-by-Step Troubleshooting Checklist

Step 1: Check Your VPN

Sometimes your VPN can block the bot’s driver manager from updating the drivers.

  1. Disconnect from your VPN.
  2. Run the bot again so it can download the correct driver.
  3. Reconnect to your VPN.

Step 2: Update Your Browser

If your browser is outdated, the driver may not match properly.

  1. Open your browser (Chrome, Edge, or Firefox).
  2. Go to Help > About.
  3. Allow the browser to update and restart.

Step 3: Manually Download the Driver

If the above steps don’t help, you can manually download the driver that matches your browser version:

Once downloaded:

  1. In the bot, go to Help > Show Config in Explorer / Finder.
  2. Edit the config.json file in a text editor.
  3. Find the selenium_drivers section.
  4. Paste the file path of the driver into the appropriate sub-key (chrome, edge, or firefox).
  5. Save the file and restart the bot.

Quick Tips

  • Windows: If the driver file is blocked, right-click → Properties → check Unblock.
  • Linux / Mac: Give the driver execute permission:
    chmod +x chromedriver
  • If you use multiple browsers, make sure each has the correct driver path set.

Still Not Working?

If the issue persists, please contact support and include:

  • A copy of the error log file
  • Your browser version number
  • Your driver version (if manually downloaded)

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.