How to schedule workflows

What this feature does

The Workflow Scheduler runs workflows automatically on a recurring basis. You configure schedules using cron expressions for precise timing or intervals for simple periodic execution. Schedules can target staging or production environments.

Scope: This guide covers creating, managing, and monitoring scheduled workflows. It does not cover building workflows (refer to How to build workflows) or one-time execution (refer to How to execute via API).

Who this applies to

• Audience: Developers and administrators scheduling recurring workflow executions
• Access required: Editor or Administrator role on the project
• Assumed knowledge: You have a committed workflow. Refer to How to publish and release for publishing workflows.

Steps

Step 1: Access the scheduler

1. Open your project from the dashboard.
2. Select the Scheduler icon (calendar clock) in the left sidebar.

The schedule table shows all configured schedules with their workflow, branch, runtime, schedule expression, status, and last updated time.

Step 2: Create a schedule

The workflow must be committed before it can be scheduled.

1. Select Create Schedule.

2. Configure the required fields:

   Field	What to set
   Workflow	Select the committed workflow
   Branch	Branch where the workflow exists (defaults to main)
   Runtime	Staging or Production
   Schedule type	Cron Expression or Interval

3. If using Cron Expression, enter a standard 5-field cron format. All times are in GMT+8 (Asia/Singapore).

   Field	Allowed values
   Minute	0–59
   Hour	0–23
   Day of month	1–31
   Month	1–12 or JAN–DEC
   Day of week	0–7 (0 and 7 = Sunday) or SUN–SAT

4. If using Interval, set the frequency (e.g., every 5 minutes, every hour).

5. Select Create to save the schedule.

Step 3: Manage schedules

• Pause/resume: Toggle a schedule between Active and Paused status.
• Edit: Update the schedule expression, runtime, or workflow.
• Delete: Remove a schedule that is no longer needed.

Constraints and limitations

Related features

• How to build workflows — create the workflows that schedules execute.
• How to publish and release — commit and release workflows before scheduling in production.