---
title: "Adding or editing a task"
manual: "Scheduler"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-scheduler:adding-editing-task@main"
source: "Administration/EditTask/Index.rst"
rendered: "2026-10-03T08:20:15+00:00"
---

# Adding or editing a task {#adding-editing-task}

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

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

> [!NOTE]
> **See also**
>
> Developers can implement and register custom tasks:
> [Creating a custom scheduler task](https://docs.typo3.org/permalink/typo3/cms-scheduler:creating-tasks@main)

**Table of contents**

-   [The scheduler task wizard](https://docs.typo3.org/permalink/typo3/cms-scheduler:the-scheduler-task-wizard@main)
-   [The scheduler task form](https://docs.typo3.org/permalink/typo3/cms-scheduler:the-scheduler-task-form@main)
-   [Scheduler task settings](https://docs.typo3.org/permalink/typo3/cms-scheduler:scheduler-task-settings@main)
-   [Task executions timing details](https://docs.typo3.org/permalink/typo3/cms-scheduler:task-executions-timing-details@main)

## The scheduler task wizard {#adding-editing-task-wizard}

![Screenshot of an empty scheduler module, No tasks defined yet.](../../Images/EmptySchedulerModule.png)

![Screenshot of the "New task" wizard in the scheduler backend module](../../Images/TaskCreationWizard.png)

> [!NOTE]
> **See also**
>
> Developers can listen to event [ModifyNewSchedulerTaskWizardItemsEvent](https://docs.typo3.org/permalink/typo3/cms-scheduler:modifynewschedulertaskwizarditemsevent)
> to influence the items displayed here.

## The scheduler task form {#adding-editing-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](../../Images/AddingATask.png)

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.

<!-- TODO: no Markdown rendering for "versionadded" -->

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 {#adding-editing-task-form-settings}

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

## Task executions timing details {#adding-editing-task-form-timing}

![Screenshot of tab "Timing" the scheduler task form](../../Images/TaskExecutionDetails.png)

-   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](https://en.wikipedia.org/wiki/Cron#CRON_expression) 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.