> For the complete documentation index, see [llms.txt](https://docs.bugbug.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bugbug.io/recording-tests-steps/record-from-here.md).

# Record from here

Record new steps at any place in an existing BugBug test: BugBug runs the test up to that point and continues recording. Change the recording position, pause, and run the new steps in the same session

You don't need to record a test from scratch to add or fix steps. **Record from here** runs the test up to the place you choose and then starts recording, so the new steps land exactly there.

## Record from a place in the test

1. Open the test and hover over the place between steps where you want to add new steps.
2. Click the `+` icon.
3. Choose **Record from here**.
4. BugBug opens a test window and runs the test locally up to this place.
5. Recording starts. Record the new steps in the test window.

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2F66hD3gpAmNOPw3Ct9WQm%2Fimage.png?alt=media&amp;token=1baa7490-b41d-4e8c-b45a-f8b4bd427084" alt=""><figcaption><p>Click "Record from here" to run the test to a given position and start recording</p></figcaption></figure>

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FPznSvOTHxbfFbTCOCNbG%2Fimage.png?alt=media&amp;token=d9ed6909-d478-4738-8518-c6a177ef7235" alt=""><figcaption><p>Recording mode in the web app</p></figcaption></figure>

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2F76vVIgu52DUmOaCYYmO5%2Fimage.png?alt=media&amp;token=c742700a-4b16-4e50-bb8d-264d5aa57794" alt=""><figcaption><p>Recording mode in the test window</p></figcaption></figure>

The new steps are added in the group where you clicked `+`, or inside the condition block if you clicked there. They're saved right away, without extra confirmation, and marked with a `new` badge.

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2F18ElPmvagA5KNQh0Bdxo%2Fimage.png?alt=media&amp;token=58cd147b-19d9-4d99-bef0-c22f4512ba85" alt=""><figcaption><p>Newly recorded steps with the new badge</p></figcaption></figure>

If you choose **Record from here** before the first step of the test, there is nothing to run, so BugBug starts recording right away.

**Record from here** isn't available while the test is running. It uses a local run, so you need the [BugBug Chrome extension](https://docs.bugbug.io/quick-start/install-test-recorder.md).

## Record at the end of the test

To add steps after the last step, click **Record from here** in the **End of test** section below the steps. BugBug runs the whole test first and then starts recording. The new steps are added in a new group at the end of the test.

![Record from here at the end of the test](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FCjPDyELf1ndYx9FEShn5%2Fimage.png?alt=media\&token=94c2f16c-a62b-4a16-9c1f-a0d81052f004)

## While you record

In the recorder overlay in the test window, click **Pause recording** to stop recording for a moment, for example to set up the state of your app by hand, or **Finish and close** when you're done.

The buttons in the test header in the web app depend on the mode:

* **Recording:** **Stop** and **Pause**.
* **Paused:** **Stop**, **Record** (record again from the current position), **Resume** (run the rest of the test) and **Run next step and pause**.

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FESPhRQH0JE5RDxLmI24O%2Fimage.png?alt=media&amp;token=f8f499c5-61eb-4904-8cf5-a773497edc6f" alt=""><figcaption><p>Pause the recording and start it again with Record</p></figcaption></figure>

### Change the recording position

You can record new steps in several places of the test in one session. While recording or paused, move the position in one of two ways:

* drag the position marker in the steps list to another place,
* click `+` at another place and choose **Record from here** or **Set playback here**.

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2F6MFAetDBQQVGX0wkRtuT%2Fimage.png?alt=media&amp;token=d4604616-b53d-4069-afed-7e02041d48e0" alt=""><figcaption><p>Drag the position marker to another place</p></figcaption></figure>

Make sure the app in the test window is in the right state for the place where you continue recording.

## Run the new steps without starting over

You can run the steps you've just recorded without running the test from the beginning:

1. Record the new steps.
2. Pause the recording.
3. Click `+` before the new steps and choose **Set playback here**.
4. Click **Resume** to run the rest of the test, or **Run next step and pause** to run one step at a time.

In paused mode, the `+` menu also has **Resume from here** and **Resume and pause here**.

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FPZlWg0dicbXhP8KL0gEy%2Fimage.png?alt=media&amp;token=1d13dcd2-d57d-4c17-9a3a-1979d763f2a7" alt=""><figcaption><p>Set the playback position and click Resume to run the new steps</p></figcaption></figure>

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2Fyhw7dDH519WMxv5kTJ3T%2Fimage.png?alt=media&amp;token=abc95091-49d4-41f9-b215-4b9ba1a29890" alt=""><figcaption><p>You can also resume from the BugBug overlay</p></figcaption></figure>

You can repeat recording and running as many times as you need.

{% hint style="info" %}
Read more in [Edit & Rewind](https://docs.bugbug.io/workflow-tips/edit-and-rewind.md), [Run and pause here](https://docs.bugbug.io/running-tests/run-and-pause-here.md) and [Re-recording steps](https://docs.bugbug.io/recording-tests-steps/re-recording-steps.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bugbug.io/recording-tests-steps/record-from-here.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
