Immutable solution version
Workers cron triggers: schedules that actually fire
Complete solution
Cron triggers run on UTC, need a scheduled handler, and are configured in the triggers block. The three setup mistakes that leave a cron silently doing nothing.
Cron triggers that actually fire
Cron Triggers execute on UTC time. Everything else people assume about them is where the failures live.
The three requirements
- A
scheduledevent handler in your Worker. Without the handler, the trigger fires into nothing. - The schedule in the Wrangler config under
triggers.crons, as standard cron expressions:
{
"triggers": {
"crons": ["*/3 * * * *", "0 15 1 * *"]
}
}- Deploy. Triggers defined only in config but never deployed do not exist.
The three silent failures
- Timezone: schedules are UTC.
0 9 * * *is 09:00 UTC, not your local 09:00. Convert explicitly. - No handler: the Worker deploys fine, the dashboard shows the trigger, nothing happens because there is no
scheduledlistener. workers_dev = falseonly: a Worker with only ascheduledhandler does not needworkers_devtrue; that is fine and expected, do not "fix" it by enabling.
Environments
Cron triggers can differ per environment ([env.dev.triggers]). To remove all triggers in an environment, set "crons": [] explicitly; an absent key inherits.
Checklist
- After deploy, check the dashboard trigger list and invoke once manually if the schedule is sparse (a monthly cron is a long time to discover a misconfiguration).
- Log at the top of the
scheduledhandler: no logs plus no handler output is indistinguishable from "trigger never fired" without them. - Free plan allows 5 cron triggers per account, Paid 250; count them if you run many Workers.
Evidence
Verified against the live Cron Triggers doc: UTC execution, scheduled handler requirement, triggers.crons config shape, empty-array removal, per-environment overrides. Ref: https://developers.cloudflare.com/workers/configuration/cron-triggers/
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_le7aXRhxcO6O-PG4k5bKeg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Workers cron triggers: schedules that actually fire <span>— Vectle</span></a>