---
title: "Events provided by the scheduler extension"
manual: "Scheduler"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-scheduler:scheduler-events@main"
source: "DevelopersGuide/Events/Index.rst"
rendered: "2026-10-08T06:49:14+00:00"
---

# Events provided by the scheduler extension {#scheduler-events}

The system extension [`typo3/cms-scheduler`](https://packagist.org/packages/typo3/cms-scheduler) provides the following
events:

**Table of contents**

-   [ModifyNewSchedulerTaskWizardItemsEvent](https://docs.typo3.org/permalink/typo3/cms-scheduler:modifynewschedulertaskwizarditemsevent@main)
-   [AfterTaskExecutionEvent](https://docs.typo3.org/permalink/typo3/cms-scheduler:aftertaskexecutionevent@main)

## ModifyNewSchedulerTaskWizardItemsEvent {#modifynewschedulertaskwizarditemsevent}

The PSR-14 event `\TYPO3\CMS\Scheduler\Event\ModifyNewSchedulerTaskWizardItemsEvent`
allows extensions to modify the items in the
[scheduler task wizard](https://docs.typo3.org/permalink/typo3/cms-scheduler:adding-editing-task-wizard@main).

> [!NOTE]
> **See also**
>
> [ModifyNewSchedulerTaskWizardItemsEvent (TYPO3 explained)](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Events/Events/Scheduler/ModifyNewSchedulerTaskWizardItemsEvent.html#ModifyNewSchedulerTaskWizardItemsEvent)
> for examples and the api information.

## AfterTaskExecutionEvent {#aftertaskexecutionevent}

The PSR-14 event `\TYPO3\CMS\Scheduler\Event\AfterTaskExecutionEvent`
is dispatched after a scheduled task (including command tasks) has been executed.
It provides the following information:

-   `getTask(): AbstractTask` — the executed task object
-   `isSuccess(): bool` — whether the task completed without exception
-   `getException(): ?\Throwable` — the thrown exception on failure, or `null` on success

Example listener:

```
use TYPO3\CMS\Scheduler\Event\AfterTaskExecutionEvent;

final class SchedulerTaskResultListener
{
    public function __invoke(AfterTaskExecutionEvent $event): void
    {
        $task = $event->getTask();
        $status = $event->isSuccess() ? 'success' : 'failure';
        // e.g. send a notification, write to a custom log, etc.
    }
}
```