---
title: "Using the browser recorder | Grafana k6 documentation"
description: "The browser recorder allows generating a k6 script based on a web session."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Using the browser recorder

> Caution
> 
> The Grafana k6 Browser Recorder extension is deprecated. Use [k6 Studio](/docs/k6-studio/) to record network traffic.

## Before you start

Before you start, consider the following:

- [Be sure to record realistically](/docs/k6/latest/using-k6/test-authoring/create-tests-from-recordings/#be-sure-to-record-realistically)
- [A hybrid approach for load testing websites](/docs/k6/latest/using-k6/test-authoring/create-tests-from-recordings/#consider-hybrid-approach-for-load-testing-websites)

> Note
> 
> Note that the browser recorders **don’t require a cloud account**. For cloud users, refer to the [Grafana Cloud](/docs/grafana-cloud/testing/k6/author-run/browser-recorder/) instructions.

## How to record

1. Install the [Chrome](https://chrome.google.com/webstore/detail/grafana-k6-browser-record/fbanjfonbcedhifbgikmjelkkckhhidl) or [Firefox](https://addons.mozilla.org/en-US/firefox/addon/grafana-k6-browser-recorder/) extension.
2. Open the extension by clicking the k6 logo.
3. Choose where to save the auto-generated script.
   
   - To save it on your local machine, select **I don’t want to save tests in the cloud**.
   - To save it on any of your Grafana Cloud k6 projects, select **Sign In**.
4. Select **Start recording** to begin recording the current browser tab.
5. When done, select **Stop recording**.
6. Save the recorded script locally or in any of your cloud projects.
7. Edit your script as necessary. Depending on the [type of load test](/docs/k6/latest/testing-guides/test-types/), you might need to change different aspects of the script. Typical changes are for [load options](/docs/k6/latest/using-k6/k6-options/) and to handle [correlation and dynamic data](/docs/k6/latest/examples/correlation-and-dynamic-data/).
8. Run the test from the CLI or Grafana Cloud k6. For more about running k6, refer to the [Running k6 guide](/docs/k6/latest/get-started/running-k6/).

## Troubleshooting. Try the HAR converter

If you experience problems recording a request, try the [HAR converter](/docs/k6/latest/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter/).

The Browser recorder uses the HAR converter under the hood. Like the Browser Recorder, the HAR converter creates a k6 script from the HTTP requests included in a HAR file.

The HAR converter can also record other tabs or pop-up windows, which the Browser Recorder cannot.

If the error persists with the HAR converter, please provide detailed information about the problem [in a new issue](https://github.com/k6io/har-to-k6/issues).