Upgrade (Admin Tools)
Only available if typo3/cms-install is installed with system maintainer permissions.
The backend module Admin Tools > Upgrade offers tools to system maintainers that are useful during Major upgrades (TYPO3 explained).

The tools listed here are mainly used during Major Upgrades of the TYPO3 Core or a third party extension.
Some tools can also be used to access the quality of custom TYPO3 extensions.
See also
There are also a number of Third-party tools useful during upgrade.
Table of contents
Core updater
In classic mode TYPO3 installations that fulfil certain criteria you can use this function to automatically do patch level TYPO3 Core updates.
Upgrade wizard
The upgrade wizard should be checked before each major Core or extension upgrade. If tasks have been left open they should be resolved before proceeding.
After each upgrade, especially major or minor upgrades, you should check if there are new upgrade wizards that need to be executed.
The upgrade wizards can only be run if no tables or columns are missing. If any are missing, create them using the Database Analyzer.
Use console commands to list and run the upgrade wizards:
# List upgrade wizards that need to be run
vendor/bin/typo3 upgrade:list
# Run a specific upgrade wizard
vendor/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard
# Run all upgrade wizards
vendor/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard
# List upgrade wizards that need to be run
typo3/sysext/core/bin/typo3 upgrade:list
# Run a specific upgrade wizard
typo3/sysext/core/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard
# Run all upgrade wizards
typo3/sysext/core/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard
Or access module Upgrade from the Admin Tools or Install Tool and then click on Run upgrade wizard....
Some upgrade wizards are not mandatory. You can choose the option "No, do not execute" to skip them.
The TYPO3 Core contains upgrade wizards for two consecutive major versions. Third party extensions can contain additional upgrade wizards for their own purposes (commonly changes to extension database records).
The extension wapplersystems/core-upgrader contains upgrade wizards older than the last two TYPO3 versions. It can be used to migrate the data from installations that need to be upgraded across more than two major versions at once.
View upgrade documentation (Changelogs)
You can read all the changelog entries that affect the current Core version in the module Admin Tools > Upgrade or read them online: TYPO3 Core Changelog Online.
The module allows you to mark changelog entries as read. Read entries are automatically hidden.
Check TCA in ext_tables.php
TCA must not be defined in file ext_tables.php
. This is because TCA
is required in the frontend context and this file is only loaded in backend context.
This tool can be used to check for incorrect or historical definitions of TCA
in ext_tables.php
.
Check for broken extensions
This tool tries to load the files ext_localconf.php
and
ext_tables.php
from all the installed extensions. It can help you to detect
which extensions are causing errors.
Extension scanner: Scan extension files

Deprecations as strong and weak matches in the extension scanner for EXT:news
When functionality is to be dropped or changed in the TYPO3 Core in the next major version it is usually already marked as deprecated in the current TYPO3 version.
Therefore, by dealing with deprecations in the current TYPO3 version you can prepare your custom extensions to also work in the next TYPO3 Core version.
The extension scanner can be used to find deprecated code in extensions.
Using the extension scanner to update custom extensions is described in more detail in Extension scanner.