Vercel cron expression builder
Build and check a Vercel cron schedule. See it in plain English, its next runs in UTC, whether it works on Hobby, and the vercel.json to paste in.
Updated
minute · hour · day of month · month · day of week
At 05:00 (UTC)
Works on every plan. On Hobby, Vercel may run it at any minute within the hour.
Next 5 runs (UTC)
- Tue 17 Nov, 05:00
- Wed 18 Nov, 05:00
- Thu 19 Nov, 05:00
- Fri 20 Nov, 05:00
- Sat 21 Nov, 05:00
vercel.json
{
"crons": [
{
"path": "/api/cron",
"schedule": "0 5 * * *"
}
]
}How Vercel cron jobs work
A Vercel cron job is an HTTP GET request that Vercel sends to a path in your project on a schedule. You declare it in vercel.json:
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"crons": [{ "path": "/api/sync", "schedule": "0 5 * * *" }]
}The schedule has five fields: minute (0–59), hour (0–23), day of month (1–31), month (1–12) and day of week (0–6, where 0 is Sunday). Each field takes *, a number, a range like 1-5, a list like 1,15, or a step like */15.
Rules that differ from standard cron
- The timezone is always UTC.
- No names: use
1, notMON. - No shortcuts like
@dailyor@hourly. - Day of month and day of week cannot both be set; one must be *.
- Jobs run only on production deployments, and Vercel does not retry a failed run.
Plan limits
| Plan | Most frequent | Timing |
|---|---|---|
| Hobby | Once a day | Any time within the scheduled hour |
| Pro and Enterprise | Once a minute | Within the scheduled minute |
Secure the endpoint
Anyone who knows the path can call it. Add a CRON_SECRET environment variable of at least 16 characters; Vercel sends it as a bearer token, and your function rejects anything else:
export function GET(request: Request) {
if (request.headers.get('authorization') !== `Bearer ${process.env.CRON_SECRET}`) {
return new Response('Unauthorized', { status: 401 });
}
// ...your job
return Response.json({ ok: true });
}Cron requests also carry the user agent vercel-cron/1.0, which helps when searching your logs.
FAQ
What timezone do Vercel cron jobs use?
Always UTC. A job scheduled for 0 9 * * * runs at 09:00 UTC, which is 04:00 in New York in winter and 17:00 in Singapore.
How often can a cron job run on the Hobby plan?
Once a day at most, and Vercel may run it at any point within the scheduled hour. A schedule that runs more often fails at deployment. Pro and Enterprise can run every minute, at the scheduled minute.
Can I use MON, JAN or @daily?
No. Vercel cron jobs accept numbers only, so write 1 instead of MON and 0 0 * * * instead of @daily.
Why can’t I set both day of month and day of week?
Vercel does not allow it. When one of the two fields has a value, the other must be *.
Do cron jobs run on preview deployments?
No. Cron jobs run only on production deployments.
How many cron jobs can a project have?
100 per project, on every plan.
Vercel, in your pocket.
Push alerts, logs, rollbacks and usage for every project. 7-day free trial for eligible subscribers.

