Whitelisting | Ranorex
Help CenterUser GuideWhitelisting

Whitelisting

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

Hint

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

Note

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

Reference

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

Result(s):

Spy browser window without whitelisting
Spy browser window with whitelisting and the Ranorex demo application in the whitelist

Ranorex Spy without / with whitelisting

Ranorex Spy without / with whitelisting