Attention

TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

delete

delete

Type: string (field name)
Path: $GLOBALS['TCA'][$table]['ctrl']
Scope: Proc. / Display

Field name, which indicates if a record is considered deleted or not.

If this "soft delete" feature is used, then records are not really deleted, but just marked as 'deleted' by setting the value of the field name to "1". In turn, the whole system must strictly respect the record as deleted. This means that any SQL query must exclude records where this field is true.

This is a very common feature. Most tables use it throughout the TYPO3 Core. The core extension "recycler" can be used to "revive" those deleted records again.

Example

Enable soft delete for the following table:

EXT:my_extension/Configuration/TCA/tx_myextension_domain_model_something.php

<?php
return [
    'ctrl' => [
        'delete' => 'deleted',
        // ...
    ],
];