Before you start recording | Ranorex Studio User Guide
Help CenterUser GuideRanorex Studio fundamentals

Before you start recording

Whether your test is simple or complex, preparation is key in test automation. Preparation prevents mistakes and saves time in the long run. This chapter describes the steps to take before you start recording your test.

In this chapter

    Recording recommendations

    Take the time to consider the following recommendations. They can make your testing life easier and your work more efficient.

    Application under test (AUT) Do you want to start the AUT yourself each time, or do you want Ranorex to start it automatically at the beginning of the recording? In either case, you need to know the installation path and any required starting parameters.
    Test data & parameters Make sure you have all test  data and parameters, such as login names and passwords, readily available for the test.
    Test instances Only run one instance of your AUT during recording.
    Recording interaction All user actions are captured during recording, even accidental ones that are unrelated to the AUT. Make sure to disable anything that could interfere with recording, such as pop-ups.

    Recording recommendations

    Further reading

    Whitelisting can ensure that Ranorex interacts with only the processes relevant to your test. Learn more in Ranorex Studio fundamentals > ⇢ Whitelisting.

    Our AUT: The Ranorex Demo Application

    To better demonstrate the concepts and methods in this User Guide, we’ve created a special app, the Ranorex Demo Application. It will serve as our AUT for the explanations and samples in the fundamentals and advanced chapters of this User Guide.

    Download the Demo Application


    Download the latest version here: ⇢ Ranorex Demo Application. Unzip it to any folder on your system. For the purpose of our tutorials, we assume that it’s located in the /Downloads/ folder.
    Default storage folder for demo application

    The Ranorex Demo App in the default folder

    Note icon


    A link to the demo application is also included with all downloadable sample solutions throughout the fundamentals and advanced chapters of this user guide.

    Start the AUT

    Before planning a test in detail, start the AUT to ensure that it is installed properly and is working.

    Browse to the location where you unzipped the Demo App.
    Double-click it.
    Opening Ranorex demo application

    Opening the Ranorex Demo Application

    The Demo App’s Welcome screen appears.

    Plan the recording

    Plan your recording well. It helps prevent tedious restructuring and editing later.

    Use a recording script

    • Think about the steps you need to record.
    • Prepare the necessary input data (usernames, passwords, etc.).
    • Perform the test at least once without recording.

    Consider the recording size

    • Keep recordings as small as possible.
    • Larger, modular test cases can be built out of smaller, reusable recordings.

    Plan how mouse movements will be recorded

    • By default, mouse movements are not recorded without mouse clicks.
    • When navigation through menus is important for the test, use mouse clicks for detection, or use the option for recording mouse movements within the Recorder control center.


    Learn about recording mouse movements in Ranorex Studio fundamentals > Ranorex Recorder > ⇢ Recorder control center & hotkeys.

    Test definition

    Following the recommendations above, we have defined a simple test with five steps. This same test serves as an example in the coming Ranorex Recorder chapters.

    1. Open the Ranorex Demo Application.

    2. In the “Enter your name” field, enter Harry and click Submit.

    Inserting & submitting a name

    Entering and submitting a name

    3. Verify that the welcome message changes accordingly.

    4. Reset the welcome message.

    5. End the demo application and stop the recording.

    Recorder default settings

    There are many settings you can configure to customize the behavior of the Recorder. The default settings are usually suitable for most recording tasks, including the ones in this chapter. However, for some recording tasks, you may need to change the Recorder settings. To access them, click Settings in the toolbar of the Recorder working environment or in the Ranorex Studio toolbar.

    Global & local Recorder settings

    Global & local Recorder settings

    Global Recorder settings
    Local Recorder settings valid for the current recording module

    Further reading

    Learn about Recorder settings and their impact on recordings in Ranorex Studio system details > Settings and configuration > ⇢ Ranorex Recorder settings.