> For the complete documentation index, see [llms.txt](https://help.aximo.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aximo.autify.com/test-case-creation/create-test-case.md).

# Create cases

Create reusable test cases from scratch on the **Cases** screen. This page explains how to create Web, Desktop, and mobile cases.

Before saving a case, also see these pages for the content you need to decide:

* How to write scenarios: [Write prompts](/test-case-creation/writing-prompts.md)
* Shared memories available for insertion: [About memories](/memories/memory-overview.md)

## Create a Web case

For a Web case, specify the scenario and format, then save the case. The saved case can run individually from the case list.

<figure><img src="/files/ZH2b4dUiMtYV1dAgoXLO" alt="Web case creation screen screenshot"><figcaption><p>Web case creation screen</p></figcaption></figure>

1. In the workspace, open the **Cases** tab.
2. Click **New Case**.
3. Optionally, enter a case name in the title field at the top of the screen.
4. In **Type**, select **Web**.
5. In **Format**, select the scenario format.
6. In **Test Scenario**, enter the action you want to verify and the expected result.
7. Optionally, to insert a variable, OTP, or file, select the item from **Insert memory** <img src="/files/gUZkHrdp751FPmYNU8dE" alt="" data-size="line">.
8. Click **Save**.

{% hint style="info" %}

* Available **Format** options are **Gherkin**, **Markdown**, and **Plain text**.
* If there are no cases yet, open the creation screen from **Create your first case**.
* If the title field is left empty, the title is automatically generated from the first non-empty line of the scenario.
  {% endhint %}

{% hint style="warning" %}
You cannot save the case if **Test Scenario** is empty.
{% endhint %}

## Create a Desktop case

For a Desktop case, save the scenario together with an optional start URL and registered device.

<figure><img src="/files/oi6XgUq5cy8YJ5l83ysT" alt="Desktop case creation screen screenshot"><figcaption><p>Desktop case creation screen</p></figcaption></figure>

1. In the workspace, open the **Cases** tab.
2. Click **New Case**.
3. Optionally, enter a case name in the title field at the top of the screen.
4. In **Type**, select **Desktop**.
5. Optionally, in **Start URL**, enter a URL.
6. In **Format**, select the scenario format.
7. In **Test Scenario**, enter the action you want to verify and the expected result.
8. Optionally, to insert a variable, OTP, or file, select the item from **Insert memory** <img src="/files/gUZkHrdp751FPmYNU8dE" alt="" data-size="line">.
9. Optionally, click **Choose Device** and select the registered device to bind to the case.
10. Click **Save**.

{% hint style="info" %}

* **Desktop** is displayed only when BYOD is enabled for the organization.
* You can save the case without choosing a device. In that case, choose the registered device when you run the case.
  {% endhint %}

{% hint style="warning" %}
You cannot save the case if **Test Scenario** is empty.
{% endhint %}

## Create a mobile case

For a mobile case, save the device and app used at run time in addition to the scenario.

<figure><img src="/files/xqcOJbK9JpHgYtCpiiaJ" alt="Mobile case creation screen screenshot"><figcaption><p>Mobile case creation screen</p></figcaption></figure>

1. In the workspace, open the **Cases** tab.
2. Click **New Case**.
3. Optionally, enter a case name in the title field at the top of the screen.
4. In **Type**, select **Mobile**.
5. In **Format**, select the scenario format.
6. In **Test Scenario**, enter the action you want to verify and the expected result.
7. Optionally, to insert a variable, OTP, or file, select the item from **Insert memory** <img src="/files/gUZkHrdp751FPmYNU8dE" alt="" data-size="line">.
8. Optionally, to save a device or app, click **Choose App & Device**.
9. Optionally, in the modal, select **iOS** or **Android**.
10. Optionally, in the **Device** section, select the device to use from the list.
11. Optionally, in the **App** section, select an existing upload, or upload a new app by dragging and dropping a file or using **Choose a file**.
12. Optionally, click **Confirm**.
13. Click **Save**.

{% hint style="info" %}

* **Mobile** is not displayed in self-hosted environments.
* If you save without selecting a device or app, select them at run time.
* Selecting an app is optional. Create a case with only a device selected if needed.
* For app selection rules, such as the maximum of 3 apps and primary app behavior, see [Apps](/memories/shared-memories/memory-apps.md#use-in-mobile-sessions-and-cases).
  {% endhint %}

{% hint style="warning" %}
You cannot save the case if **Test Scenario** is empty.
{% endhint %}

## Organize cases in directories

Organize cases in a workspace hierarchically with directories. Grouping cases by release target, feature area, purpose, or similar criteria makes it easier to find the target case from the list.

Directories are managed per workspace and are not shared with other workspaces. Cases that are not in a directory are treated as **Unassigned**.

<figure><img src="/files/lwD8AqY8KcAmBv2947FF" alt="Directory sidebar screenshot"><figcaption><p>Directory sidebar</p></figcaption></figure>

### Open the directory sidebar

1. In the workspace, open the **Cases** tab.
2. Click the folder icon (**Toggle directory sidebar**) to the left of the search box.
3. The **Directory** sidebar opens on the left and shows **All Cases**, **Unassigned**, and the existing directory list.

### Create a folder

1. In the upper-right corner of the **Directory** sidebar, click the **New Folder** icon.
2. Enter **Folder name**.
3. Click **Create Folder**.

To create a subfolder directly under an existing folder, open the **⋮** menu for the target folder and select **New Subfolder**.

{% hint style="warning" %}

* Enter a folder name with 255 characters or fewer.
* You cannot use `/`.
* You cannot create folders with the same name under the same parent folder.
  {% endhint %}

### Rename, move, or delete a folder

1. In the **Directory** sidebar, find the target folder.
2. Open the **⋮** menu for the target folder, then select an action.
   * **Rename**: Enter a new **Folder name**, then click **Rename**.
   * **Move folder**: Select **/ (Root)** or another folder as the destination.
   * **Delete**: Check the content, then click **Delete**.

{% hint style="info" %}

* Move a folder by dragging it onto another folder. To return it to the root, drop it on **All Cases**.
* You cannot move a folder under itself or under one of its subfolders.
  {% endhint %}

{% hint style="warning" %}
When you delete a folder, its subfolders are also deleted, and cases under it are moved to **Unassigned**. The cases themselves are not deleted.
{% endhint %}

### Move a case to a folder

Change the folder of each case from the case list.

1. In the case list, click the **Move to folder** icon in the target case row.
2. In the displayed dialog, select the destination folder or **Unassigned**.

## Enable API triggers

To run the created case from a CI/CD pipeline or any script, enable API access from **API Trigger** in the case details. For specific steps, how to check the API endpoint, and how to include it in CI/CD, see [Run with API triggers](/test-execution-and-plans/api-cicd-integration.md).

## Further reading

* [About sessions and cases](/test-case-creation/test-case-creation-overview.md)
* [Test session](/test-case-creation/create-test-session.md)
* [Apps](/memories/shared-memories/memory-apps.md)
