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

# Create Test Plan

> This guide walks you through creating a Test Plan from start to finish, enabling you to execute coordinated testing across multiple 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
* Understanding of which test suites you want to include

## How to Create Test Plans

<Steps>
  <Step title="Navigate to Test Plans">
    Open your Spur Dashboard and locate **Test Plans** in the left navigation menu under the Tests section.

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-02at2.21.44PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=5e8f289104038e877c9b09e1e4458b84" alt="Screenshot 2026 02 02 At 2 21 44 PM" width="762" height="742" data-path="images/Screenshot2026-02-02at2.21.44PM.png" />
    </Frame>
  </Step>

  <Step title="Create Your First Test Plan">
    On the Test Plans page, click the **Create Test Plan** button to begin setup.

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-02at2.15.22PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=5980b717baddef66a716f17eeef4133f" alt="Screenshot 2026 02 02 At 2 15 22 PM" width="2182" height="448" data-path="images/Screenshot2026-02-02at2.15.22PM.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-02at2.16.27PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=31fe25c4f86cdffcb0ed621e53f10f4b" alt="Screenshot 2026 02 02 At 2 16 27 PM" width="2538" height="1334" data-path="images/Screenshot2026-02-02at2.16.27PM.png" />
    </Frame>
  </Step>

  <Step title="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.
    </Note>

    You can customize what runs in your Test Plan by:

    * **Select Specific Tests** – Choose individual tests from each test suite instead of running the full suite
    * **Choose Environments** – Specify which environments (e.g. staging, production) the tests should run against
    * **Configure 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.

    <Frame>
      <img src="https://mintcdn.com/spur/-kGswOS1KFY-omef/images/Screenshot2026-02-05at3.50.57PM.png?fit=max&auto=format&n=-kGswOS1KFY-omef&q=85&s=a9f6574465dd340470b3ee812be3837d" alt="Screenshot 2026 02 05 At 3 50 57 PM" width="2554" height="1404" data-path="images/Screenshot2026-02-05at3.50.57PM.png" />
    </Frame>
  </Step>

  <Step title="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 from the dropdown
      * Configure alert preferences (when to notify: on finish, on fail, on every run). See [Alerts and Notifications](/running-tests/test-plans#alerts-and-notifications) for details.
    * **Auto Retry Failed Tests** – Set the maximum number of retry attempts (1, 2, or 3) for failed tests. See [Retry on Failure](/running-tests/test-plans#retry-on-failure) for how this works.

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-02at2.19.45PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=486862baed67f68295f9882560f13805" alt="Screenshot 2026 02 02 At 2 19 45 PM" width="2540" height="1416" data-path="images/Screenshot2026-02-02at2.19.45PM.png" />
    </Frame>
  </Step>

  <Step title="Create Test Plan">
    Review your configuration and click **Create Test Plan** to save. Your Test Plan is now created and ready to execute.

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-02at2.20.50PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=d97d6ee12f3dec555ef6eb72cdad5006" alt="Screenshot 2026 02 02 At 2 20 50 PM" width="2218" height="420" data-path="images/Screenshot2026-02-02at2.20.50PM.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-02at2.21.07PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=f68eb07929735987bbd461115fe68d77" alt="Screenshot 2026 02 02 At 2 21 07 PM" width="798" height="414" data-path="images/Screenshot2026-02-02at2.21.07PM.png" />
    </Frame>
  </Step>
</Steps>

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