cron.json

by Christian Clausen

on Jun 29, 2025 (created Nov 14, 2024) • 1 min

The cron.json file, is one of the special-purpose files in the event-configuration folder. This file specifies recurring events to post and their schedules.

File Format

The format for the file is

interface CronConfig {
  [event: string]: {
    expression: string,
    timezone?: string,
  }
}

Where expression uses the Cron format and timezone is a TZ Identifier .

Example

In this example, we have two recurring events. One posts a minute event every minute. Another posts a daily event every day at 2 pm CET.

cron.json
{
  "minute": { "expression": "* * ? * * *" },
  "daily": { "expression": "0 14 ? * * *", "timezone": "CET" }
}

Deploying Recurring Events

When we deploy the event configurations, all event schedules are updated to match the cron.json file. You can deploy event-configurations with the CLI:

$ mm deploy