# Install Test Recorder

### Why do you need the test recorder?

To run and record the tests, BugBug requires you to install a Chrome Extension-based test recorder.

This extension must be installed and **enabled** **in** **Incognito** **mode**.

![](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FVvgslBkDmC4EpLso0FFG%2FScreenshot%202026-03-31%20at%2015.35.28%201.png?alt=media\&token=39eef28a-af03-4915-870c-4d9aca88eca0)

### Why does the extension require incognito mode?

Each test should run in complete isolation to ensure reliability and consistency. This means starting every test with a clean environment — free of cookies, cache, localStorage, and other session data.

To achieve this, BugBug executes tests in Incognito mode. Every test run begins by closing any existing Incognito session and opening a new window, guaranteeing a fresh, clean state each time.

### Install the extension

Go to [BugBug Extension on the Chrome Webstore](https://chrome.google.com/webstore/detail/bugbug-no-code-test-autom/oiedehaafceacbnnmindilfblafincjb/related) and install it.

![If you try to run or record the test without the extension you will see a prompt](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FEcwnZ2QvzFXkfLehw4xv%2FScreenshot%202026-03-31%20at%2015.42.08%201.png?alt=media\&token=68ca00ba-5c32-4bcc-9b24-5061a98759bc)

### Enable the extension in Incognito mode

![If you don't enable the extension in incognito mode, you will ba asked to do so before running a test](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FEQe1JGmQvjKIJ4bA2ttT%2FScreenshot%202026-03-31%20at%2015.42.49%201.png?alt=media\&token=887cd871-6080-452e-a52f-ab22cf403ecd)

1. Go to extension settings by clicking the **"Go to extension settings"** button or use the link below

`chrome://extensions/?id=oiedehaafceacbnnmindilfblafincjb`

Scroll down, then enable the switch near **"Allow in Incognito"**

![](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2Fu9D4Te8HyJ5prfUWai3L%2FScreenshot%202026-03-31%20at%2015.44.07%201.png?alt=media\&token=d9b16e78-f8ad-491c-8ca4-f2f9d9e69ddc)

That's it! You're ready to run and record the tests now.

***

#### \[Opera Only] Allow access to search page results

The BugBug extension requires the 'Allow access to search page results' permission to function properly in Opera. When this option is disabled, Opera blocks access to sandboxed iframes, such as reCAPTCHA. Therefore, attaching to tabs containing these types of frames is not allowed.

{% hint style="info" %}
We take your privacy seriously. This permission is used solely for recording and running tests.\
We never collect, store, or share your search queries or personal data.
{% endhint %}

1. Go to extension settings by clicking the "Go to extension settings" button or use the link below

   `chrome://extensions/?id=oiedehaafceacbnnmindilfblafincjb` 
2. Scroll down, then enable the switch near "Allow access to search page results"

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FbYjT9lCWPJTdlEHbIypj%2Fbugbug-incognito-enable-screen%20-%20opera%2004.11.2025.png?alt=media&#x26;token=3090b95e-d8be-4c19-877d-465ac58f94ed" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bugbug.io/quick-start/install-test-recorder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.