> ## 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.

> ## Agent Instructions
> Spur is an AI-powered QA engineer that lets teams create and run automated end-to-end tests for web and mobile apps using natural language.
> When answering questions about Spur, cite the relevant page from docs.spurtest.com.

# Create Test Plan

> Create a Test Plan to run coordinated tests across environments and browsers.

## Prerequisites

Before creating a Test Plan, ensure you have:

* At least one configured test suite with completed setup
* Environments configured for your application

## How to create Test Plans

**1. Navigate to Test Plans**

Open your Spur Dashboard and locate **Test Plans** in the left navigation menu under the Tests section.

![Test Plans in the left navigation menu](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/test-plans-nav-menu.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=c4abc00d52a04426fc416b95955588d7)

**2. Create your first Test Plan**

On the Test Plans page, click the **Create Test Plan** button to begin setup.

![Create Test Plan button on the Test Plans page](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/create-test-plan-button.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=14b05e2b3322a1a6408dcd963eae14e2)

**3. Configure plan details**

Complete the initial configuration form with your Test Plan information:

* **Test Plan Name** — Enter a descriptive name that clearly identifies the purpose (e.g., "Production - Smoke Test")
* **Environments** — Select which environments this Test Plan will test against. Choose from your configured environments.
* **Choose Default Browsers for Tests** — Select the browsers that tests will run on by default. Available options include Chrome, Safari, Microsoft Edge, and Firefox.
* **Description** — Add optional context explaining the Test Plan's purpose (e.g., "Regression tests for checkout flow")

Click **Add Suites** to proceed to the next step.

![Test Plan configuration form with name, environments, and browsers](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/test-plan-configuration-form.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=d9e7cf98909839057d5a7ff0aee39218)

**4. Add Test Suites**

Select which test suites to include in your Test Plan. Use the search bar to find specific suites quickly.

> [!NOTE]
>
> Only test suites with matching environments and completed configuration can be added to your Test Plan.

You can customize what runs in your Test Plan by:

* **Selecting specific tests** — Choose individual tests from each test suite instead of running the full suite
* **Choosing environments** — Specify which environments (e.g. staging, production) the tests should run against
* **Configuring browser coverage** — Define which browsers and devices each suite will run on

The selection summary at the bottom shows your total suites, tests, and runs.

![Suite selection screen with the selection summary at the bottom](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/suite-selection-summary.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=129bcdc35f486cd789279946e5ea8a83)

**5. Configure additional settings**

Customize how your Test Plan executes and integrates with your workflow:

* **Enable CI/CD Integration** — Toggle on to connect this Test Plan to your deployment pipeline for automated testing.
* **Schedule Test Plan** — Configure when your Test Plan runs:
  * Set the start date and time
  * Select which days of the week to run (for recurring schedules)
  * Choose custom intervals if needed
* **Integrations** — Connect to communication channels:
  * Select your Slack channel and set **When to post** to **On finish**, **Every run**, **Final fail**, or **Every fail**
  * Add one or more email recipients and choose **Always**, **Failures only**, **Failures and warnings**, or **Never** for run emails. Select **Send after review** for recipients who should also receive reviewed results
  * See [Alert Notifications](https://docs.spurtest.com/running-tests/test-plans.md#alert-notifications) for details.
* **Auto Retry Failed Tests** – Set the maximum number of retry attempts (1, 2, or 3) for failed tests. See [Auto Retry](https://docs.spurtest.com/running-tests/test-plans.md#auto-retry) for how this works.

![Additional Settings with CI/CD, schedule, integrations, and auto retry options](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/additional-settings-test-plan.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=d38830bf491398368ea86fd163dbb8bf)

**6. Create the Test Plan**

Review your configuration and click **Create Test Plan** to save. Your Test Plan is now created and ready to execute.

![Review screen with the Create Test Plan button](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/review-create-test-plan.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=e6a722b38638873980c29379dd4ad258)

**7. Manage your Test Plan**

Access Test Plan management options through the three-dot menu:

* **Edit Plan** — Modify Test Plan configuration, suites, or settings
* **Duplicate Plan** — Create a copy to use as a template for similar testing needs
* **Delete** — Remove the Test Plan permanently

![Three-dot menu with Edit, Duplicate, and Delete options](https://mintcdn.com/spur/8SIYEB8X4PSFcROt/images/managing-tests/test-plans/create-test-plan/test-plan-three-dot-menu.png?fit=max\&auto=format\&n=8SIYEB8X4PSFcROt\&q=85\&s=354def8cf94f90200c0bfab04fa66f35)

## Next steps

After creating your Test Plan, you can:

* **Run the Test Plan** immediately using the Run Plan button.
* **Configure additional suites** by editing the Test Plan.
* **Set up automated scheduling** for recurring test execution.
* **View results** post-execution to analyze test outcomes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.