SmoothDeploy Docs
Operations

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

  1. Go to Operations → Schedules in the sidebar.

The list shows every schedule for the active project. Click any row to open the detail page.

ColumnNotes
NameLinks to the detail page.
TypeTest, Directory, or Tag.
BranchBranch the schedule targets. Shows "Deleted Branch" if the branch no longer exists.
StatusEnabled or Disabled.
ScheduleCron expression (recurring) or scheduled date-time (one-time).
CreatedWhen the schedule was created.

Create a Schedule

  1. Click Create Schedule.
  2. Fill in the fields described below.
  3. Click Create.

Fields

FieldNotes
Schedule NameRequired. Max 64 characters.
BranchWhich branch to run tests from. Defaults to your current active branch.
Schedule TypeSingle Test, Directory, or Tag — see below.
TargetShown 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 ModeRecurring (repeats on a cron) or One-time (fires once).
Recurring PatternPreset 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 ConfigurationBrowser, 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.

PresetCron produced
Daily at midnight0 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 UTC
  • 0 0 * * 1 — every Monday at midnight UTC
  • 30 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

ButtonWho can use itWhat it does
Trigger NowAll rolesFires the schedule immediately, bypassing the cron.
EditAdmins and ownersOpens an edit dialog with the same fields as the create dialog. Not shown for one-time schedules.
Enable / DisableAll rolesToggles whether the schedule fires on its cron.

A disabled schedule can still be triggered manually with Trigger Now.

Next Steps