Installation

Getting started with QAlity takes less than 2 minutes. There is no desktop app to download - everything runs through a Chrome extension.

Setup steps

When you click Start recording for the first time in QAlity, a popup appears that guides you through 2 steps to set up the recorder.

Step 1 - Install the Chrome extension

1. Open QAlity and start recording

   Go to app.qality.dev, sign in, open or create a test case, and click Start recording. A popup titled QAlity Recorder will appear.

2. Click Install from Chrome Web Store

   In the popup click the Install from Chrome Web Store button. This opens the QAlity Recorder listing. Click Add to Chrome and then Add extension to confirm.

   Install QAlity Recorder

   Already installed? Go back to QAlity and refresh the window. The popup will move to Step 2 automatically.

Step 2 - Allow in Incognito

After installation is confirmed the popup moves to Step 2.

3. Click Open extension settings

   In the popup click Open extension settings. This opens chrome://extensions directly to the QAlity Recorder settings page.

4. Turn on Allow in Incognito

   In the extension settings find the Allow in Incognito toggle and turn it on. QAlity shows a preview image in the popup highlighting exactly where this toggle is with a red outline.

   Tests run in Incognito so cookies and stored data do not carry over between runs. This gives every test a clean consistent starting state.

5. You are ready

   Go back to QAlity. The recorder is now set up. Click Start recording to begin your first test. QAlity will open your website in an Incognito window and start capturing your actions.

   You can also skip the Incognito step by clicking I don't want to enable this in the popup. Recording will still work without it.

If your organization restricts Chrome extensions, ask your IT admin to allowlist the QAlity Recorder extension ID: pookkcjcilhpikkomgbipdhpebbikjoe

What permissions the extension needs

When you install QAlity Recorder, Chrome will show a permissions prompt. Here is what each permission is for:

Read and change data on websites

Needed to record your clicks, inputs, and navigation actions on the page you are testing.

Access to tabs

Needed to open your web app in a new tab and start the recording session.

Storage

Used to temporarily store recording session data while you are actively recording a test.

QAlity Recorder does not collect personal data, does not run outside of active recording sessions, and does not access any pages unless you start a recording.

What to do after installation

Create your first test

Open QAlity, go to Test Cases, create a new case and start recording your first flow.

Full walkthrough

Follow the Your first test guide for a step by step walkthrough of recording, saving, and running a test.

Learn about the Recorder

Find out what the recorder captures, how to re-record, and tips for better recordings.