Task files 

Each task is one YAML file in config/scheduler/. The file name, without the .yaml or .yml extension, is the task's identifier. It links the file to its database record and may only contain lowercase letters, digits, - and _.

config/scheduler/cleanup-deleted.yaml 
type: 'cleanup:deletedrecords'
description: 'Remove deleted records older than 30 days'
group: 'Maintenance'
execution:
  frequency: '0 3 * * *'
parameters:
  options:
    min-age: 30
Copied!

Reference 

Name Type Required
type
 string true
description
 string
group
 string
disabled
 bool
priority
 int
execution
 array true
execution.frequency
 string or int
execution.start
 string or int
execution.end
 string or int
execution.multiple
 bool
parameters
 array
type
Type
string
Required

true

A schedulable console command, such as cleanup:deletedrecords, or a scheduler task class, such as TYPO3\CMS\Scheduler\Task\OptimizeDatabaseTableTask.

description
Type
string

Shown in the Scheduler module.

group
Type
string

Name of the task group. A group that does not exist yet is created.

disabled
Type
bool
Default
false

Set to true to import the task disabled.

priority
Type
int
Default
100

50 (low), 100 (regular) or 150 (high). Only TYPO3 14 knows task priorities; TYPO3 13 ignores the key.

execution
Type
array
Required

true

When the task runs. Needs execution.frequency, or execution.start for a task that runs once.

execution.frequency
Type
string or int

A cron expression such as '0 3 * * *', or an interval in seconds such as 3600. Without a frequency, the task runs once at execution.start.

execution.start
Type
string or int

The first run, as a date or a Unix timestamp. Optional for recurring tasks: they then start counting from the import. Required for tasks without frequency.

execution.end
Type
string or int

The last run. A task past its end is imported disabled.

execution.multiple
Type
bool
Default
false

Set to true to allow several executions of the task at the same time.

parameters
Type
array

The task's own settings, see Task parameters.

Dates accept every format PHP's DateTimeImmutable understands, for example '2026-01-01 04:00'. They are read in the server's time zone.

Examples 

An interval task that may run in parallel 
type: 'language:update'
description: 'Update language packs hourly'
priority: 150
execution:
  frequency: 3600
  multiple: true
parameters:
  options:
    fail-on-warnings: true
Copied!
A task that runs once 
type: 'cleanup:orphanrecords'
execution:
  start: '2026-12-24 22:00'
Copied!