Adding or editing a task 

Administrators can add or edit scheduler tasks in the backend module System > Scheduler.

When adding a new scheduler task a wizard will allow you to select a task type from several categories.

Table of contents

The scheduler task wizard 

Screenshot of an empty scheduler module, No tasks defined yet.

Click on "New task" to add a task

Screenshot of the "New task" wizard in the scheduler backend module

Choose the task to be created

The scheduler task form 

When adding or editing a task, the following form will show up:

Screenshot of the form to Create new Scheduler task on root level

Adding a new scheduled task

Some fields require additional explanations (inline help is available by moving the mouse over the field labels):

  • A disabled task will be skipped by the command-line script. It may still be launched manually, as described above.

New in version 13.3

Similar to editing regular content elements, it is now possible to save scheduler tasks being edited via keyboard shortcuts as well.

It is possible to invoke the Ctrl/Cmd + s hotkey to save a scheduler task, altogether with the hotkey Ctrl/Cmd + Shift + S to save and close a scheduler task.

Scheduler task settings 

Some tasks allow additional settings to be made in the area Settings. These fields differ from task to task

Task executions timing details 

Screenshot of tab "Timing" the scheduler task form

Choosing a frequency for a recurring task

  • A task must have a start date. It defaults to the time of creation. The server's time appears at the bottom of the form.
  • Task can be run a single time or recurring.
  • The frequency needs be entered only for recurring tasks. It can be either an integer number of seconds or a cron-like schedule expression. Scheduler supports ranges, steps and keywords like @weekly. See en.wikipedia.org for more information. See \TYPO3\CMS\Scheduler\CronCommand\CronCommand and \TYPO3\CMS\Scheduler\CronCommand\NormalizeCommand class references in the TYPO3 CMS source code for definitive rules.
  • Parallel executions are denied for recurring tasks. They can be allowed by checking "Allow Parallel Execution"

If an error occurs when validating a cron definition, the Scheduler's built-in cron parser tries to provide an explanation about what's wrong.