Associate Browser

Attaches a browser instance to a new or an existing web automation scope.

Command availability: IBM RPA SaaS and IBM RPA on premises

Script syntax

IBM RPA's proprietary scripting language has a syntax similar to other programming languages. The script syntax defines the command's syntax in the script file. You can work with this syntax in IBM RPA Studio's Script mode.

webAttach --browser(Browser) --name(String)


Use the Start Browser (webStart) command to start a browser or use the Find Internet Explorer Browser (findBrowser) command to attach the Microsoft Internet Explorer before using the Associate Browser (webAttach) command.

Input parameter

The following table displays the list of input parameters available in this command. In the table, you can see the parameter name when working in IBM RPA Studio's Script mode and its Designer mode equivalent label.

Designer mode label Script mode name Required Accepted variable types Description
Browser browser Required Browser Browser to attach to the web automation scope. Obtain the Browser instance using the Start Browser or Find Internet Explorer Browser commands.
Name name Required Text Browser instance name. You may use the same name from the instance created by the Start Browser command.


The Start Browser command starts the Goole Chrome and the Mozila Firefox browsers. Each browser refers to one browser instance. The web automation scope is in the last browser started (Mozilla Firefox). So, the Associate Browser attaches the Google Chrome browser instance to the current web automation scope again to use it to continue navigating.

defVar --name chrome --type Browser
defVar --name firefox --type Browser
webStart --name browserChrome --type "Chrome" chrome=value
// Navigate to web page using the Google Chrome browser instance.
webNavigate --url ""
webStart --name browserFirefox --type "Firefox" firefox=value
// Navigate to web page using the Mozila Firefox browser instance.
webNavigate --url ""
webAttach --browser ${chrome} --name browserChrome
// Navigate to web page using the Google Chrome browser instance.
webNavigate --url ""
webClose --name browserChrome --leavebrowseropen
webClose --name browserFirefox