> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scoutqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Schedules

> Automate recurring test runs so Scout checks your application on a regular basis without manual intervention.

Schedules let you set up automated, recurring test runs for your application. Instead of manually starting a test every time you want to check for issues, Scout can automatically run tests on a daily or weekly basis—catching regressions before your users do.

<video controls className="w-full rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/scoutqa/wznNq5k3r1rzirTC/images/schedule-demo.mp4?fit=max&auto=format&n=wznNq5k3r1rzirTC&q=85&s=ddbc7cc87bffc44b44554330d3f10e98" data-path="images/schedule-demo.mp4" />

## Why use schedules

Manual testing is great for ad-hoc exploration, but it doesn't scale. With schedules, you can:

* **Catch regressions early**: Automated daily checks help you spot issues introduced by recent deployments before they impact users.
* **Ensure consistent coverage**: Regular testing means no area of your app goes unchecked for too long.
* **Save time**: Set it once and let Scout do the work. Focus your energy on building features, not running tests.
* **Get notified automatically**: Receive email summaries after each scheduled run completes, so you can start your day knowing the state of your application.

## Creating a schedule

<img src="https://mintcdn.com/scoutqa/wznNq5k3r1rzirTC/images/Create-schedule.png?fit=max&auto=format&n=wznNq5k3r1rzirTC&q=85&s=9cd39c639ef86afc429d76213eae57c3" alt="Create schedule dialog" width="1968" height="1003" data-path="images/Create-schedule.png" />

1. Navigate to your project
2. Click **Schedules** in the sidebar
3. Click **New Schedule**
4. Fill in the schedule details:
   * **Label**: A descriptive name for this schedule (e.g., "Daily Smoke Test", "Weekly Regression Check")
   * **URL**: The starting URL for the test run. Click "Use project URL" to use your project's default URL.
   * **Instructions** (optional): Any specific instructions for Scout during this scheduled run (e.g., "Focus on the checkout flow", "Test the new dashboard feature")
5. Configure the schedule timing:
   * **Frequency**: Choose between Daily or Weekly
   * **Time (UTC)**: Select when the test should run. The local time equivalent is shown for your convenience.
   * For weekly schedules, select which days of the week to run
6. Click **Create Schedule**

<Tip>
  Schedule your tests to run during off-peak hours when your application has lower traffic. Early morning (UTC) works well for many teams.
</Tip>

## Managing schedules

<img src="https://mintcdn.com/scoutqa/wznNq5k3r1rzirTC/images/Schedule-list.png?fit=max&auto=format&n=wznNq5k3r1rzirTC&q=85&s=f8b34ee2bda426c59680bb2e8b4c04cc" alt="Schedules list" width="1968" height="1007" data-path="images/Schedule-list.png" />

The Schedules page shows all configured schedules for your project with:

* **Label**: The name you gave the schedule
* **Schedule**: A human-readable description of when it runs (e.g., "Runs every day at 09:00 UTC")
* **Next Run**: When the schedule will execute next
* **Active**: Toggle to pause or resume the schedule

### Editing a schedule

Click the pencil icon next to any schedule to modify its settings. You can update:

* The label and URL
* Custom instructions
* Frequency and timing

Changes take effect immediately and will apply to the next scheduled run.

### Pausing and resuming

Use the **Active** toggle to temporarily pause a schedule without deleting it. This is useful when:

* Your application is undergoing maintenance
* You're deploying major changes and want to pause automated tests
* You need to temporarily reduce test frequency

Paused schedules retain all their settings and can be reactivated at any time.

### Deleting a schedule

To remove a schedule entirely, edit the schedule and look for the delete option. Deleted schedules cannot be recovered.

## Schedule timing

### Frequency options

<CardGroup cols={2}>
  <Card title="Daily" icon="calendar-day">
    Runs every day at your specified time. Ideal for smoke tests and catching daily regressions.
  </Card>

  <Card title="Weekly" icon="calendar-week">
    Runs on selected days of the week. Choose one or more days for more comprehensive but less frequent testing.
  </Card>
</CardGroup>

### Time zones

All schedule times are configured in **UTC** to ensure consistent execution regardless of daylight saving changes or team location. The interface shows the equivalent time in your local timezone for convenience.

<Note>
  If your local time shows "+1 day" or "-1 day", it means the UTC time falls on a different calendar day in your timezone.
</Note>

## Email notifications

After each scheduled test run completes, Scout automatically sends an email summary to your account.

<img src="https://mintcdn.com/scoutqa/2xBmOWGQIWSSW14y/images/email.png?fit=max&auto=format&n=2xBmOWGQIWSSW14y&q=85&s=2bc8f0ab1cd15d89e764dc8215406509" alt="Email notification after execution" width="2143" height="1248" data-path="images/email.png" />

The email includes:

* **Execution summary**: Start time, duration, and completion status
* **Issues found**: Total number of issues discovered during the test run
* **Top issues**: A quick preview of the most important issues with their severity levels (High, Medium, Low)
* **Quick actions**: Direct links to review and fix issues, run another test, or share results with your team
* **View Full Execution**: One-click access to the complete execution details

This means you can stay informed about your application's health without logging in—perfect for morning standup prep or staying on top of overnight test results.

## Best practices

<AccordionGroup>
  <Accordion title="Start with daily smoke tests">
    Begin with a single daily schedule targeting your most critical user flows. Once you're comfortable with the results, expand to additional schedules or weekly deep dives.
  </Accordion>

  <Accordion title="Use descriptive labels">
    Name your schedules clearly so anyone on your team understands what each one does. For example: "Daily - Homepage & Login", "Weekly - Full E2E Regression".
  </Accordion>

  <Accordion title="Add focused instructions">
    Use the Instructions field to guide Scout toward specific areas or behaviors. This is especially useful for weekly schedules where you want more targeted testing.
  </Accordion>

  <Accordion title="Stagger multiple schedules">
    If you have several schedules, set them to run at different times to avoid overwhelming your application and to spread out the review work.
  </Accordion>

  <Accordion title="Review results regularly">
    Scheduled tests are only valuable if you act on the findings. Set aside time to review the email summaries and address discovered issues promptly.
  </Accordion>
</AccordionGroup>

## Viewing scheduled run results

Results from scheduled runs appear in your project's **Executions** list alongside manually triggered tests. Scheduled executions are indistinguishable from manual ones in terms of features—you get the same detailed timeline, chat history, screenshots, and issue tracking.

To find scheduled runs:

1. Go to your project's **Executions** page
2. Look for executions that ran at your scheduled times
3. Click any execution to view the full details

<Note>
  Each scheduled run counts toward your plan's execution quota. Monitor your usage if you have multiple active schedules.
</Note>
