---
title: "Deprecation: #107550 - Table Garbage Collection Task configuration via $GLOBALS"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-107550-1736193200"
source: "Changelog/14.0/Deprecation-107550-TableGarbageCollectionTaskConfigurationViaGlobals.rst"
typo3-version: "14.0"
typo3-major: 14
type: "deprecation"
issue: 107550
forge: "https://forge.typo3.org/issues/107550"
tags: ["PHP-API", "Scheduler", "TCA", "FullyScanned", "ext:scheduler"]
rendered: "2026-09-20T18:31:11+00:00"
---

# Deprecation: #107550 - Table Garbage Collection Task configuration via $GLOBALS {#deprecation-107550-1736193200}

See [forge#107550](https://forge.typo3.org/issues/107550)

## Description {#description}

The `\TYPO3\CMS\Scheduler\Task\TableGarbageCollectionTask` has been
migrated to use TYPO3's native TCA-based task configuration system. As part of
this migration, the previous configuration method using

`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][TableGarbageCollectionTask::class]['options']['tables']`

has been deprecated and will be removed in TYPO3 v15.0.

## Impact {#impact}

Using the old configuration method will trigger a PHP deprecation warning.
The functionality continues to work for now, with the deprecated configuration
being merged with the new TCA-based configuration automatically.

## Affected installations {#affected-installations}

Any installation that configures custom tables for the
`TableGarbageCollectionTask` using the
deprecated `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']` configuration.

The extension scanner will report any usage as a **weak match**.

## Migration {#migration}

Instead of configuring tables via `$GLOBALS['TYPO3_CONF_VARS']`, tables
should now be configured in TCA using the `taskOptions` configuration of
the corresponding record type within `Configuration/TCA/Overrides/`.

Before (deprecated):

**ext_localconf.php**

```php
use TYPO3\CMS\Scheduler\Task\TableGarbageCollectionTask;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks']
    [TableGarbageCollectionTask::class]['options']['tables']
    ['tx_myextension_my_table'] = [
        'dateField' => 'tstamp',
        'expirePeriod' => 90,
    ];
```

After (new method):

**Configuration/TCA/Overrides/scheduler_table_garbage_collection.php**

```php
use TYPO3\CMS\Scheduler\Task\TableGarbageCollectionTask;

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    $GLOBALS['TCA']['tx_scheduler_task']['types']
        [TableGarbageCollectionTask::class]['taskOptions']['tables']
        ['tx_myextension_my_table'] = [
            'dateField' => 'tstamp',
            'expirePeriod' => 90,
        ];
}
```

It is also possible to modify the tables added by TYPO3, for example changing the
`expirePeriod` of table `sys_log`:

```php
use TYPO3\CMS\Scheduler\Task\TableGarbageCollectionTask;

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    $GLOBALS['TCA']['tx_scheduler_task']['types']
        [TableGarbageCollectionTask::class]['taskOptions']['tables']
        ['sys_log']['expirePeriod'] = 240;
}
```

The new TCA-based configuration provides the same functionality while
integrating better with TYPO3's native scheduler task system and FormEngine.