> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/testfirst-editor/writing-test-cases/record-test-cases-using-the-recorder.md).

# Record Test Cases using the Recorder

### What is the Recorder?

The **Recorder** allows you to create automated tests by capturing your actions in a browser.

Instead of writing steps manually, you can:

* Click through your application
* Type into inputs
* Navigate between pages

The Recorder converts these actions into structured test steps automatically.

### When to Use the Recorder

Use the Recorder when you want to:

* Quickly create UI test cases
* Capture real user flows
* Add steps to an existing test
* Avoid writing Gherkin manually

It’s the fastest way to turn manual testing into automation.

***

### Before You Start

To use the Recorder, you need:

* **TestFirst Utilities Pack** is installed and **Test Runner** is running

If the Recorder button is disabled:

* Download the **Utilities Pack**
* Install utilities pack and run the **Test Runner**

***

### How to Record a New Test

{% stepper %}
{% step %}

#### Open TestFirst Editor

Open a test case in the **TestFirst Editor**
{% endstep %}

{% step %}

#### Click Recorder

{% endstep %}

{% step %}

#### Enter website URL

Enter the URL you want to test
{% endstep %}

{% step %}

#### **Click Start Recording**

{% endstep %}

{% step %}

#### Perform actions in the browser 

* Click elements
* Type text
* Navigate pages
* Assertions
  {% endstep %}

{% step %}

#### Stop

Click **Stop** when finished
{% endstep %}

{% step %}

#### Review and edit the generated steps

{% endstep %}

{% step %}

#### **Click Save**

{% endstep %}
{% endstepper %}

Your recorded actions are now converted into an automated test.

***

### What the Recorder Captures

The Recorder currently supports capturing the following actions:

* **Clicks** (buttons, links, tables)
* **Typing** (inputs, forms)
* **Basic navigation flows**
* **Table Interactions**

  (intelligently detect table relationships to interact with rows and cells)
* **Assertions** (verifying elements are displayed)

***

### Tips for Best Results

💡 **Use Recorder whenever possible**\
Recorder is the fastest and easiest way to create automated tests in TestFirst.

💡 **Record realistic user flows**\
Record clear, intentional actions and avoid unnecessary clicks or navigation

💡 **Review recorded steps before saving**\
This helps ensure the test logic is correct and clean.

💡Add validations to make tests more reliable

***

### Next Steps

After recording a test case, you can:

* Run the test using the **Test Runner**
* Run the test from a **Test Scope**
* Add additional actions or assertions