Welcome to the Ranorex Support Portal

Settings & configuration

This chapter introduces and explains the various options for setting and configuring Ranorex Studio and its tools.

In this chapter

Machine-stored settings

If you access settings from a Ranorex tool without a solution associated with it, the settings are stored on the machine in a Ranorex internal file structure.

Machine-stored settings

How to access machine-stored settings:

  1. Click the SETTINGS button from stand-alone Spy

  2. Click the settings button from Ranorex Studio start page (with no solution opened)

  3. Click stand-alone Ranorex Settings program from Windows start menu

Settings dialog:

  1. See the settings title with no solution associated

  2. See the information stating that the settings are stored on the machine and not with a solution

Solution-stored settings

Whenever you access settings from a Ranorex tool with an associated solution, the settings are stored in this solution.

Solution-stored settings

How to access solution-stored settings:

  1. Click the SETTINGS button in Ranorex Studio while a solution is opened

  • This option opens an extended settings dialog with …
  • Current recording settings dialog and …
  • Current repository settings dialog register tab


Click the settings toolbar button in Ranorex Studio to open the regular settings dialog

Settings dialog:

  1. See the setting title with associated solution name

  2. See the information stating that the setting is stored in the associated solution

User-settings & solution-settings

User settings are always stored locally on a machine and include user-specific settings related to the Ranorex Studio working environment.

Solution settings include all settings which relate to the test solution, such as plugins, RanoreXPath generation, Ranorex Recorder defaults and many more, which can be shared between different systems, within teams and also be put under Version control.

User-settings & solution-settings distinction
  1. User-settings are printed in regular font

  2. Solution settings are printed in italic font

Solution settings file

The solution settings are saved in the settings file Ranorex.rxsettings, which is located in the ‘Solution Items’ folder of the corresponding solution. 

Solution settings file
  1. Solution settings file in project file view of Ranorex Studio

Note Icon


  • Do not change the name of the folder or the file
  • If you remove the settings file (Ranorex.rxsettings), the solution settings stored on the local machine are automatically used during test execution
  • If you open the settings file, it is shown in its raw format. It is not recommended to edit the file in this view

Adding a solution settings file

If a solution does not contain a settings file, it can be added following the below-listed instructions.

Creating a solution settings file
  1. Click the Create solution settings in the ‘Projects view’ toolbar of a solution

Solution settings and test execution

The solution settings file Ranorex.rxsettings is automatically copied into the output directory of the test project. It is saved in the same folder as the test executable. This is why the solution settings will be used for test execution.

Note Icon


  • Do not rename the solution settings file
  • When deploying the test executable, make sure to include the solution settings.

If the solution settings are not stored in the same folder as the test executable, the solution settings from the local machine will be used. 

Solution settings and Ranorex Remote

When selecting a solution for remote test execution, the solution settings saved in this solution will automatically be sent to the Ranorex Agent and used during test execution. 

If the solution does not include a solution settings file, the solution settings stored locally on the Ranorex Agent’s machine will automatically be used during test execution.



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved