Whitelisting | Ranorex
Help CenterUser GuideWhitelisting



By default, Ranorex will scan all running processes on your computer when tracking UI elements. With whitelisting, you can focus Ranorex on only the processes relevant for your test.

This has two advantages:

  • It increases performance during test recording, execution, and in Ranorex Spy
  • It helps you create clean recordings, as only the relevant processes can be interacted with.
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 will open.

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

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

When you’re done, click Apply whitelist.
Note icon


Endpoints will still appear in Spy. They are not affected by whitelisting.


Find out more about endpoints in: Web and mobile testing > Endpoints > ⇢ Getting started

Before whitelisting

After whitelisting