--- title: "Module \"Upgrade\" (System)" manual: "TYPO3 Explained" version: "main" permalink: "https://docs.typo3.org/permalink/t3coreapi:admin-tools-upgrade@main" source: "Administration/Tools/Upgrade/Index.rst" modified: "2026-09-14T11:10:56+00:00" --- # Module "Upgrade" (System) > [!NOTE] > **Changed in version 14.0** > > This module has been moved from **Admin tools** to **Settings**. > See also: [Feature: #107628 - Improved backend module naming and structure](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/14.0/Feature-107628-ImprovedBackendModuleNamingAndStructure.html#feature-107628-1729026000). Only available if [`typo3/cms-install`](https://packagist.org/packages/typo3/cms-install) is installed with system maintainer permissions. The backend module **System > Upgrade** offers tools to system maintainers that are useful during [Major upgrades (TYPO3 explained)](https://docs.typo3.org/permalink/t3coreapi:major@main). ![System > Upgrade, Overview](../../../Images/ManualScreenshots/AdminTools/UpgradeTools.png) The tools listed here are mainly used during [Major Upgrades of the TYPO3 Core or a third party extension](https://docs.typo3.org/permalink/t3coreapi:upgrading@main). Some tools can also be used to access the quality of custom TYPO3 extensions. > [!NOTE] > **See also** > > There are also a number of [Third-party tools useful during upgrade](https://docs.typo3.org/permalink/t3coreapi:tools@main). **Table of contents** - [Core updater](https://docs.typo3.org/permalink/t3coreapi:core-updater@main) - [Upgrade wizard](https://docs.typo3.org/permalink/t3coreapi:upgrade-wizard@main) - [View upgrade documentation (changelogs)](https://docs.typo3.org/permalink/t3coreapi:view-upgrade-documentation-changelogs@main) - [Check for broken extensions](https://docs.typo3.org/permalink/t3coreapi:check-for-broken-extensions@main) - [Extension scanner: scan extension files](https://docs.typo3.org/permalink/t3coreapi:extension-scanner-scan-extension-files@main) ## Core updater In classic mode TYPO3 installations that fulfil certain criteria you can use this function to automatically do patch level TYPO3 Core updates. > [!NOTE] > **See also** > > - [Minor upgrades - using the Core updater](https://docs.typo3.org/permalink/t3coreapi:classic-mode-upgrade-minor@main) > - [Disabling the Core updater in a classic mode installation](https://docs.typo3.org/permalink/t3coreapi:classic-mode-upgrade-disable@main) ## Upgrade wizard ![Upgrade wizard](../../../Images/ManualScreenshots/Upgrade/UpgradeWizard.png) 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](https://docs.typo3.org/permalink/t3coreapi:admin-tools-maintenance-database-analyzer@main). Use console commands to list and run the upgrade wizards: **Composer-based installation** **typo3_root$ (Composer mode)** ```bash # 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 ``` **Classic mode installation (no Composer)** **typo3_root$ (Classic mode)** ```bash # 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 ``` Or access module **System > Upgrade** from the backend 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`](https://packagist.org/packages/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 **System > Upgrade** or read them online: [TYPO3 Core Changelog Online](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Index.html#typo3-core-changelog). The module allows you to mark changelog entries as read. Read entries are automatically hidden. ## Check for broken extensions This tool tries to load the files [`ext_localconf.php`](../../../ExtensionArchitecture/FileStructure/ExtLocalconf.md#file-extension-ext-localconf-php) from all the installed extensions. It can help you to detect which extensions are causing errors. ## Extension scanner: scan extension files ![The extension scanner report with strong and weak matches](../../../Images/ManualScreenshots/AdminTools/ExtensionScanner.png) 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](https://docs.typo3.org/permalink/t3coreapi:extension-scanner@main).