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

# Scheduled Tests

> Run your test plans automatically at set intervals — no manual triggering required.

## Overview

The Scheduler lets you run test plans on a recurring basis. Set a frequency, pick your start time, and Spur handles the rest. Use it for continuous monitoring, regression testing, or pre-deployment validation across any environment.

## How to Schedule a Test Plan

<Steps>
  <Step title="Navigate to Scheduler">
    From your Spur dashboard, click **Scheduler** in the left navigation.

    <Frame caption="Open the Scheduler from the left navigation">
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step1-3.gif?s=ddcc7943fee41ad0883a96369bb6b0db" alt="Navigate to Scheduler" width="1952" height="1080" data-path="images/step1-3.gif" />
    </Frame>
  </Step>

  <Step title="Click Schedule Test Plan">
    Click **Schedule Test Plan** to open the schedule configuration modal.

    <Frame caption="Click Schedule Test Plan to get started">
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step2-1.gif?s=69502f41e65dd6003440fbf158178dae" alt="Schedule Test Plan button" width="1884" height="1080" data-path="images/step2-1.gif" />
    </Frame>
  </Step>

  <Step title="Configure Your Schedule">
    Fill in the schedule details:

    * **Test Plan** — Select the test plan you want to schedule
    * **Date and Time** — Set when the first execution should occur
    * **Interval** — Choose how often to run the test plan

    <Frame caption="Configure your test plan schedule">
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step3-3.png?fit=max&auto=format&n=BvhWQtDOy3g9ZJZN&q=85&s=a0572d02dd194f24a8d54c65805adcae" alt="Schedule configuration modal" width="948" height="820" data-path="images/step3-3.png" />
    </Frame>

    There are two interval options:

    **Custom Interval**

    Set a specific cadence in hours, days, weeks, or months between executions.

    <Frame caption="Custom interval configuration">
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step3.1.png?fit=max&auto=format&n=BvhWQtDOy3g9ZJZN&q=85&s=2b8040b0d5d40105e0dc8d50725724ae" alt="Custom interval" width="836" height="184" data-path="images/step3.1.png" />
    </Frame>

    **Weekly Preset**

    Choose specific days of the week for the test plan to run.

    <Frame caption="Weekly preset configuration">
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step3.2.gif?s=9de45842d82b900a7f7b206268132ace" alt="Weekly preset" width="1232" height="1080" data-path="images/step3.2.gif" />
    </Frame>
  </Step>

  <Step title="Save Your Schedule">
    Click **Schedule Test Plan** to confirm. Your test plan will now run automatically on the schedule you configured.

    <Frame caption="Save the schedule to activate it">
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/step4.gif?s=9a6eae2934cd95c146eff3843aa098c5" alt="Save schedule" width="1876" height="1080" data-path="images/step4.gif" />
    </Frame>
  </Step>
</Steps>

## Scheduling from a Test Plan

You can also schedule a test plan directly from the Test Plan settings without navigating to the Scheduler.

<Steps>
  <Step title="Open the Test Plan menu">
    Navigate to [Test Plans](/managing-tests/test-plans/test-plans), find the plan you want to schedule, and click the **three-dot menu**.

    <Frame caption="Click the three-dot menu on the Test Plan you want to schedule">
      <img src="https://mintcdn.com/spur/2ZfFX4VnsvdwSmY9/images/step1-5.gif?s=f1165657060ea0c43247c9de9e24f7d7" alt="Step1 5" width="1944" height="1080" data-path="images/step1-5.gif" />
    </Frame>
  </Step>

  <Step title="Select Edit Test Plan">
    Click **Edit Test Plan** to open the Test Plan configuration modal.

    <Frame caption="Select Edit Test Plan from the menu">
      <img src="https://mintcdn.com/spur/2ZfFX4VnsvdwSmY9/images/step2-2.gif?s=dffefee79b1713c121153a7a9aba3ada" alt="Step2 2" width="1936" height="1080" data-path="images/step2-2.gif" />
    </Frame>
  </Step>

  <Step title="Go to Additional Settings">
    Navigate to the **Additional Settings** tab where you can configure the schedule, along with [alert notifications and auto retry](/running-tests/test-plans#alert-notifications). Click **Save Changes** to activate the schedule.

    <Frame caption="Configure the schedule in the Additional Settings tab">
      <img src="https://mintcdn.com/spur/2ZfFX4VnsvdwSmY9/images/step3-1.gif?s=6c9f7231b4e091a91605e9d744597f2f" alt="Step3 1" width="1936" height="1080" data-path="images/step3-1.gif" />
    </Frame>
  </Step>
</Steps>

## How to Edit a Schedule

<Steps>
  <Step title="Find Your Scheduled Test Plan">
    Go to **Scheduler** and locate the test plan you want to edit. Hover over it to reveal the edit icon.

    <Frame caption="Hover over a scheduled test plan to reveal the edit icon">
      <img src="https://mintcdn.com/spur/lrrfi2BWgTMkxyYA/images/updatestep1.gif?s=9c3cc7488dc43ced3babb6f232f3e08f" alt="Find scheduled test plan" width="2212" height="1080" data-path="images/updatestep1.gif" />
    </Frame>
  </Step>

  <Step title="Open the Edit Modal">
    Click the edit icon to open the schedule configuration modal.

    <Frame caption="Click the edit icon to open the configuration modal">
      <img src="https://mintcdn.com/spur/lrrfi2BWgTMkxyYA/images/updatestep2.gif?s=88a9d6f32edd6e1acc1d32db9183e908" alt="Edit schedule modal" width="1700" height="1080" data-path="images/updatestep2.gif" />
    </Frame>
  </Step>

  <Step title="Update and Save">
    Make your changes and click **Save Changes**.

    <Tip>
      Use the pause button to temporarily stop a schedule without deleting it.
    </Tip>

    <Frame caption="Save your updated schedule">
      <img src="https://mintcdn.com/spur/lrrfi2BWgTMkxyYA/images/updatestep3.gif?s=aa7f01b6625de330f88ffb6c3d9732a1" alt="Save updated schedule" width="1240" height="1080" data-path="images/updatestep3.gif" />
    </Frame>
  </Step>
</Steps>

## Best Practices

<Columns cols={2}>
  <Card icon="gauge" title="Match Frequency to Impact">
    Use high-frequency schedules (every 30 min to 2 hours) for critical production monitoring, daily for regression, and weekly for full browser matrix runs.
  </Card>

  <Card icon="globe" title="Isolate Environments">
    Use separate schedules for production and pre-production. Different environments often need different run frequencies and notification channels.
  </Card>

  <Card icon="database" title="Keep Test Data Ready">
    Ensure test data is available at scheduled run times. For pre-production, use cleanup scripts to reset state between runs.
  </Card>

  <Card icon="chart-line" title="Review Schedule Health">
    Regularly review pass/fail trends. Investigate consistently failing tests, update schedules as test plans evolve, and remove obsolete ones.
  </Card>
</Columns>
