# Create web test cases

> Create a test case for a web app, record or learn its automated steps with Copilot in a browser, and run it in a test run or plan.

Create a test case for a web app, then have Copilot automate it in a browser in the cloud or on your own computer. A test case has no app type of its own. You choose **Web** when you start a Copilot session, and again in the run configuration that runs the test case.

## Create the test case

1. Open **Test Cases** in the left navigation and open the folder the test case belongs in.
2. Click **Create**, or press `C`. The dialog opens with **Documentation** selected as the template type and the folder you opened in the folder chip.
3. Enter a title and, optionally, a description.

   ![The Create test case dialog, with the template type and folder chips and the title outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_create_dialog.webp)

   To change the template type, click the **Documentation** chip and select **Steps**. The dialog looks the same either way; the difference is in the test case editor. **Documentation** gives one free-text field each for preconditions, steps, and expected results. **Steps** gives a preconditions field and a list of separate steps, each with its own expected result.

   ![The template type list open in the dialog, with Documentation and Steps outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_template_type_menu.webp)

4. If the folder chip reads **Select a Folder**, click it, select a folder, and click **Select Folder**. Without a folder, Arcus shows "Folder is Required" and doesn't create the test case.
5. Click **Create**. The test case opens on the **Details** tab.
6. **(Optional)** To have Copilot learn the steps, enter the manual steps under **Steps**. Arcus saves them automatically.

For the template types and the other properties in the dialog, see [Manage test cases](https://testsigma.com/docs/arcus/v2/create-and-manage/test-cases/#create-a-test-case).

Only test cases with the status **Ready** can be added to test runs and run templates. If the project uses Review Management, get the test case reviewed before you plan a run. See [Review test cases](https://testsigma.com/docs/arcus/v2/create-and-manage/test-cases/#review-test-cases).

## Start a Copilot session

1. Open the **Automated steps** tab. If the test case has manual steps, click **Learn with Copilot**. Otherwise, click **Author with Copilot**. The **Copilot configuration** panel opens.

   

   
   Clicking either button replaces the tab's empty state with the step editor, even if you then click **Cancel**. To open the panel again, click **Debug with Copilot** in the header, or **Learn with Copilot** if the test case has manual steps.
   

2. In **What you are authoring**, select **Web**.
3. In **Where to run**, select **Cloud** or **My local machine**.
4. Under **Test machine**, choose the browser:
   - **Cloud**: select the **OS & Version**, **Browser**, and **Resolution**. Arcus provisions the machine when the session starts.
   - **My local machine**: select a browser in **Browser on this machine**. The Arcus Agent must be running on your computer. See [Install the Arcus Agent](https://testsigma.com/docs/arcus/v2/get-started/installation/arcus-agent/).

   ![The Copilot configuration panel with Web, Cloud, and the Test machine fields Linux ubuntu, Chrome 147, and 1920x1080 outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_copilot_config.webp)

5. If the app's URLs or credentials come from an environment, select it in **Variables from**. The section appears once the project has an environment.
6. Click **Start Copilot**. The session opens in a new browser tab and shows "Spinning up your cloud browser" or "Starting your local session". When the browser is ready, the Copilot panel sits beside it.

For every setting in the panel, see [Copilot configuration](https://testsigma.com/docs/arcus/v2/copilot/configuration/). If a local Chrome opens its store page for the Testsigma Recorder extension, see [Record and author](https://testsigma.com/docs/arcus/v2/copilot/record-and-author/#the-browser-opens-the-testsigma-recorder-page).

## Record the steps

If you clicked **Author with Copilot**, the session asks **Which page should I open?**

1. Enter the address of the page where the test starts.

   ![The Start recording prompt in the Copilot panel, with the URL field and Start recording outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_start_recording.webp)

2. Click **Start recording**. Copilot adds a **Navigate to** step for the page, runs it, and starts recording. The banner reads "Your actions are becoming steps."
3. Use the app in the browser. Each click, entry, and scroll appears in the step list marked **RECORDED**.

   ![The Copilot panel while recording, with Stop recording and a recorded Click on step outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_recording.webp)

4. **(Optional)** To add a check, hover over an element in the browser. The card that appears names the element and its locator. Click **Verify** and select a check, such as **is visible**. **Store** saves a value from the element for later steps.

   ![The Verify menu on an element card, with is visible, is enabled, is editable, its value, its placeholder, and More.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_verify_menu.webp)

5. Click **Stop recording**.

To remove a step you didn't mean to record, hover over it, click the ellipsis icon (⋮), and click **Delete**. Arcus deletes it at once, without a confirmation. For what each action records, see [Record and author](https://testsigma.com/docs/arcus/v2/copilot/record-and-author/).

## Learn the steps

If you clicked **Learn with Copilot**, click **Start learning** in the Copilot panel. Copilot runs the manual steps in the browser and writes the automated steps. See [Learn with Copilot](https://testsigma.com/docs/arcus/v2/automation/explore-and-automate/).

## Check and save the steps

1. Click **Restart execution**. Copilot runs every step from the start. Each step that passes shows a check mark and its duration, and the footer reads "Paused at the end of the test".

   ![The Copilot panel after Restart execution, with the three passed steps outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_steps_passed.webp)

   If a step fails, fix it, then click the ellipsis icon (⋮) on the step and click **Run from here**.

   ![The step menu, with Run from here outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_step_menu.webp)

2. Click the exit icon at the top of the Copilot panel.
3. In **End session and close this tab?**, click **End session**. On **Cloud**, Arcus releases the cloud machine.

   ![The End session and close this tab? dialog, with End session and Dismiss.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_end_session_dialog.webp)

Back on the test case, the **Automated steps** tab lists the steps, **Automation Type** shows **Automated**, and the header shows **Debug with Copilot**. The session appears in **LAST 1 RUN** at the top of the right panel and on the **Run history** tab as a Copilot run. If the steps don't show yet, refresh the page.

![The test case after the session, with the Automated steps tab, Debug with Copilot, and the LAST 1 RUN card outlined.](https://s3.amazonaws.com/static-docs.testsigma.com/arcus/application_types/apps_web_test_case_after.webp)

## Run the test case

Add the test case to a [test run](https://testsigma.com/docs/arcus/v2/run-tests/test-runs/#create-a-test-run) or a [run template](https://testsigma.com/docs/arcus/v2/run-tests/test-runs/#create-a-run-template) with a run configuration for **Web**. See [Web configurations](https://testsigma.com/docs/arcus/v2/run-tests/run-configurations/#web-configurations).

To replay or fix the steps later, click **Debug with Copilot** on the test case. See [Debug and run with Copilot](https://testsigma.com/docs/arcus/v2/automation/copilot/).
