> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spurtest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Video to Test Generation

> Import existing Playwright, Selenium or other automation scripts and transform them into Spur test steps that can be executed with the Spur Agent. For imports beyond Playwright and Selenium, reach out to your dedicated CSM for assistance.

## Overview

Video to Test Generation enables you to create tests by simply recording yourself navigating through your application.

Spur analyzes your video, detects actions and converts them into structured test steps while eliminating manual test authoring and accelerating test coverage creation.

<Tip>
  The fastest way is to simply paste a **Loom link** and click **Generate**. In seconds, your recording becomes a fully structured test.
</Tip>

**Supported Video Formats:**

* MP4
* MOV
* AVI
* Loom recording links

<Warning>
  Video files are limited to 30MB. For larger recordings, use Loom links which have no size restrictions.
</Warning>

## Quick Start with Loom

The easiest and most fun way to create tests from video:

1. Record your workflow in Loom (with narration for best results)
2. Copy the Loom link
3. Follow the Steps below!

## Best Practices for Recording

* **If speaking, describe what actions you're taking and what rules exist for the action**: Narration provides context that improves test step accuracy and validation logic
* **Record at a steady pace to ensure accurate step detection**: Avoid rushing through actions; give each interaction 2-3 seconds
* **Perform clear, distinct actions**: Make intentional clicks and interactions rather than hovering or exploring
* **Avoid rapid mouse movements**: Slow, deliberate cursor movement helps the AI detect your intended actions
* **Include any necessary waiting times in your recording**: If pages load slowly or animations play, let them complete in the recording

## How to Generate Tests from Video

<Steps>
  <Step title="Navigate to Dashboard and Create a New Test">
    Open your Spur Dashboard. Click **New** and choose **Test** from the dropdown menu to begin the test creation process.

    <Frame>
      <img src="https://mintcdn.com/spur/RaeB6Oz5SVRJ2dhu/images/newtestcopy.gif?s=c373301fd9784970f2082aebe2d8aede" alt="Newtestcopy" width="2172" height="1080" data-path="images/newtestcopy.gif" />
    </Frame>
  </Step>

  <Step title="Name Your Test and Select Test Suite">
    Enter a name for your test and add it to an existing Test Suite or create a new one. Click **Create Test** to proceed.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at7.06.44PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=cb8b589145ea4c4a0dc0051069ed37d8" alt="Screenshot 2026 02 04 At 7 06 44 PM" width="786" height="526" data-path="images/Screenshot2026-02-04at7.06.44PM.png" />
    </Frame>
  </Step>

  <Step title="Configure Test URL">
    The Test Editing Side Peek will open and fill in the Test URL field. Reference [Environments](/authoring-tests/environments/environments) for configuring environment-specific URLs.

    <Frame>
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step3-1.png?fit=max&auto=format&n=BvhWQtDOy3g9ZJZN&q=85&s=d18d9555597b8196a9948286dd70da62" alt="Step3 1" width="2238" height="1400" data-path="images/step3-1.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Auto-Generate and Click From Video">
    Locate the **Auto-generate** button in the Test Steps section and click **Video or Loom Link** to access the video import feature.

    <Frame>
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step4.png?fit=max&auto=format&n=BvhWQtDOy3g9ZJZN&q=85&s=85e7de0f293eb4ed76fb8422a1953c5c" alt="Step4" width="1138" height="894" data-path="images/step4.png" />
    </Frame>
  </Step>

  <Step title="Upload Video or Paste Loom Link">
    From the **Generate Test Steps from Video** window, choose your preferred method:

    <Steps>
      <Step title="Option 1: Paste a Loom Link">
        Simply paste your Loom recording URL and click **Generate Steps**. That's it and your test steps will be generated in seconds!

        <Frame>
          <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step5.1.gif?s=d48f9c39c3b6ce3a6e1e36f8d80b0fd1" alt="Step5 1" width="2076" height="1080" data-path="images/step5.1.gif" />
        </Frame>

        <Warning>
          Loom recordings must be made within the last two weeks of uploading to generate tests.
        </Warning>
      </Step>

      <Step title="Option 2: Upload a Video File">
        Choose a video file from your computer if you have a local recording (supports files up to 30MB).

        <Frame>
          <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step5.2.png?fit=max&auto=format&n=BvhWQtDOy3g9ZJZN&q=85&s=eb896843c0f69934e178e4e9ed0254d1" alt="Step5 2" width="1146" height="890" data-path="images/step5.2.png" />
        </Frame>
      </Step>
    </Steps>
  </Step>

  <Step title="Generate Steps">
    Once you've selected your method, click **Generate Steps** and Spur will process your video and extract actions into test steps.
  </Step>

  <Step title="Confirm Steps Once Uploaded">
    Spur analyzes your video and creates structured test steps based on your actions. Review the generated steps and determine if you need to add any additional test steps.

    If there are any errors or you want to refine the steps, you can:

    * Click **Regenerate** to load the video or loom link again
    * **Ask the AI** to add or make changes to specific steps
    * Add new steps using the **Add Test Step** button
    * Manually edit test steps in the list

    Once satisfied, click **Add to Test** to continue.

    <Frame>
      <img src="https://mintcdn.com/spur/lrrfi2BWgTMkxyYA/images/step6.png?fit=max&auto=format&n=lrrfi2BWgTMkxyYA&q=85&s=c213d9b309a7561bd8efb53df54bf071" alt="Step6" width="2238" height="1404" data-path="images/step6.png" />
    </Frame>
  </Step>

  <Step title="Configure and Save">
    You will return to the Test Editing Side Peek with the generated steps added to your test.

    Configure viewport settings, [Advanced Configurations](/authoring-tests/test-side-peek/advanced-configurations), and caching options as needed. Reference [Create Your First Test](/getting-started/first-test) for detailed guidance on these settings.

    After configuration, click **Save Test** to save your video-generated test.

    <Frame>
      <img src="https://mintcdn.com/spur/lrrfi2BWgTMkxyYA/images/step7.gif?s=75ce6e1fdb8d3c4766b6233948940cfd" alt="Step7" width="1724" height="1080" data-path="images/step7.gif" />
    </Frame>
  </Step>

  <Step title="View Your Test">
    Your test is now saved and you can view it in your selected Test Suite. The test is ready to run with the Spur Agent.

    <Frame>
      <img src="https://mintcdn.com/spur/lrrfi2BWgTMkxyYA/images/step8.png?fit=max&auto=format&n=lrrfi2BWgTMkxyYA&q=85&s=30c408b3cf6e4c2e18dcc0b601d6ae2d" alt="Step8" width="2150" height="366" data-path="images/step8.png" />
    </Frame>
  </Step>
</Steps>
