Endpoint configurations | Ranorex
Help CenterUser GuideWeb and mobile testing

Endpoint configurations

Endpoint configurations allow you to tell a Selenium WebDriver endpoint how to behave and act during test execution. Selenium calls these characteristics of an endpoint ‘capabilities’. Most commonly, they define what OS, browser, and browser version the WebDriver endpoint simulates. In Ranorex, the sum of all capabilities set up for an endpoint is called a ‘configuration’.

Endpoint configurations make it possible to easily execute tests in a Selenium grid on multiple different system configurations without actually needing to have any of these systems present.


To get started, you will need to have ⇢added at least one WebDriver endpoint. Once you have done so, click the icon to the right of the endpoint and select ‘View Details’.

The endpoint’s properties will be displayed, where the configuration controls are located.

Click on ‘Add new configuration’ to add a configuration.

The following dialog will appear:

Enter a name for your configuration. You can also enter a description, if you like.

In the ‘Capabilities JSON’ text box at the bottom, enter the JSON that defines the configuration’s capabilities. Selenium provides a list of available capabilities here. If you don’t know your way around JSON, simply click the link at the bottom to access our ⇢capabilities configurator. It’s easy to use and will automatically generate the JSON based on your selections. Simply paste the generated JSON into the text box and click ‘Save’ to finish.

The configuration can now be selected from the ‘Active configuration’ drop-down menu. It will also appear in the ‘Available configurations’ list. The currently active configuration is always indicated by a green icon to its left in this list.