Schedules
Automatically run tests on a cron schedule or at a single future time
Schedules run tests without any human trigger. Pick a recurring cron cadence or a one-time date, point it at a test, directory, or tag, and SmoothDeploy fires the run for you.
Permissions
All roles can view schedules and trigger, pause, or resume them. Admins and owners can also create, edit, and delete schedules. See Roles and permissions.
Schedules List
- Go to Operations → Schedules in the sidebar.
The list shows every schedule for the active project. Click any row to open the detail page.
| Column | Notes |
|---|---|
| Name | Links to the detail page. |
| Type | Test, Directory, or Tag. |
| Branch | Branch the schedule targets. Shows "Deleted Branch" if the branch no longer exists. |
| Status | Enabled or Disabled. |
| Schedule | Cron expression (recurring) or scheduled date-time (one-time). |
| Created | When the schedule was created. |
Create a Schedule
- Click Create Schedule.
- Fill in the fields described below.
- Click Create.
Fields
| Field | Notes |
|---|---|
| Schedule Name | Required. Max 64 characters. |
| Branch | Which branch to run tests from. Defaults to your current active branch. |
| Schedule Type | Single Test, Directory, or Tag — see below. |
| Target | Shown after picking a type. Only active tests or directories with at least one step appear. For Tag, only tags that have at least one test appear. |
| Schedule Mode | Recurring (repeats on a cron) or One-time (fires once). |
| Recurring Pattern | Preset or custom. See below. |
| Run At (UTC) | For One-time mode: a date (today through three months out) and a time. The scheduled time must be in the future. |
| Test Configuration | Browser, mode, timeouts, retries, workers, video, trace, screenshot. |
Schedule Types
- Single Test — runs one leaf test. Only active tests with at least one step are listed.
- Directory — runs every leaf test inside a directory. Only active directories are listed.
- Tag — runs every test that carries the selected tag.
Recurring Patterns
Choose Preset to pick from four common cadences, or Custom to type a cron expression directly.
| Preset | Cron produced |
|---|---|
| Daily at midnight | 0 0 * * * |
| Daily at... | 0 {hour} * * * |
| Weekly on... | 0 {hour} * * {weekday} |
| Monthly on... | 0 {hour} {day} * * |
Custom format: five space-separated fields — minute hour day month weekday. All times are UTC. Use * for "any".
Examples:
0 9 * * *— every day at 09:00 UTC0 0 * * 1— every Monday at midnight UTC30 14 1 * *— 1st of every month at 14:30 UTC
Schedule Detail Page
Click a schedule row to open its detail page.
The Schedule Information card shows the status (Enabled / Disabled), type, mode, branch, and the cron expression or scheduled date.
The Execution Statistics card shows total runs, last run time, and created and updated dates.
Test Runs lists the 10 most recent runs triggered by this schedule. Click any run to open the full run detail.
Actions
| Button | Who can use it | What it does |
|---|---|---|
| Trigger Now | All roles | Fires the schedule immediately, bypassing the cron. |
| Edit | Admins and owners | Opens an edit dialog with the same fields as the create dialog. Not shown for one-time schedules. |
| Enable / Disable | All roles | Toggles whether the schedule fires on its cron. |
A disabled schedule can still be triggered manually with Trigger Now.