Whitelisting | Ranorex
Help CenterUser GuideWhitelisting


When tracking UI elements, Ranorex scans all running processes on your computer by default. With whitelisting, you can focus Ranorex on only the processes relevant for your test.

This has two advantages:

  • It increases performance during test recording, test execution, and in Ranorex Spy
  • It helps you create clean recordings since you can interact only with whitelisted processes.
tipp icon


Plan ahead which processes will be part of your test and add them to your whitelist.

Editing your whitelist

In Ranorex Studio, go to View > Whitelist. The whitelist pad opens.

Click Edit whitelist… if your whitelist is empty or click the whitelist icon in the top right of the pad.

The edit window appears. In it, add processes to the whitelist or remove them using the buttons. If a process isn’t listed on the left, you can add it directly to the whitelist by clicking Add process and browsing to it.

When you’re done, click Apply whitelist.

Note icon


Endpoints are not affected by whitelisting, and so will still appear in Spy.


Find out more about endpoints in

Web and mobile testing > Endpoints > ⇢ Getting started


Ranorex Spy without / with whitelisting

Spy browser window without whitelisting
Spy browser window with active whitelisting and the Ranorex Studio Demo Application in the whitelist