<< Back to Getting started page
This is a step by step guide on how to upgrade an installation of TYPO3 to a newer version.
notice - Note
notice - Note
Read the notes
You should not only go through the upgrade notes, which this page has for the version, to which you are updating, but also the notes for any intermediate versions, as these might also contain instructions you should follow.
You should also read the Release Notes of the main versions you go through when updating (e.g. 6.2.0 and 7.6.0). These documents contain a section called "Upgrading", which you should follow. See list of all Release Notes.
Upgrading to 6.2 Long Term Support
Situation: You want to upgrade from version 6.1 to 6.2.
You need PHP 5.3.7 at least!
You must use TYPO3 4.5 or newer before you upgrade to TYPO3 6.2! Some upgrade wizards are not available anymore in 6.2 LTS, which makes it impossible to update from a version older than TYPO3 4.5 to TYPO3 6.2.
Information on LTS to LTS Upgrade
Several resources are available making an upgrade from TYPO3 4.5 to TYPO3 6.2 easier:
A smooth migration extension is available - it is especially useful for upgraders from TYPO3 4.5. It can be downloaded from TER (smoothmigration) or from its GitHub repository. Additional information on smooth migration is available in the Forge smooth migration project.
The Installation and Upgrade Guide has a new chapter on updating from TYPO3 4.5 to TYPO3 6.2.
- Truncate all cf_* tables due to outdated cached information.
- The folder t3lib/ has been removed; remove the according symlink!
Upgrading to 7.6 Long Term Support
Situation: You want to upgrade from version 6.2 to 7 LTS.
You need PHP 5.5 at least!
You must use TYPO3 6.2 or newer before you upgrade to TYPO3 7 LTS! Make sure that before you upgrade to TYPO3 7.6, you have run all Upgrade Wizards in TYPO3 6.2. Upgrade wizards from before 6.2 LTS are not available anymore in 7, which makes it impossible to update from a version older than TYPO3 6.2.
An overview of all major changes in TYPO3 CMS is available here: https://docs.typo3.org/typo3cms/extensions/core/7.6/Index.html.
- The possibility of having a file called
typo3conf/extTables.phphas been deprecated. Instead of having code in this file, use extensions!
- If you are using content elements with
multimedia, the extension mediace will be added to your installation to handle these CTypes. Alternatively, in TYPO3 7, you can install the system extension fluid_styled_content, which is an experimental replacement for css_styled_content. For media content elements you can then use the "Text & Media" content element type of this extension. Note that fluid_styled_content will remove a number of CTypes, among them
textpic("Text & Images"), from the New Content Element wizard. When fluid_styled_content is installed and css_styled_content is not, there will be an upgrade wizard to migrate content elements, which use CTypes originally provided by css_styled_content. Note that you will most likely have to adjust your CSS styles in order to again get the Frontend output you want! For videos on YouTube, Vimeo and so on, another option is the "online media" feature of the Core; see 61799: TYPO3 Core - Improve the handling of media files [Resolved; assigned to Frans Saris] and its documentation.
- There is an Upgrade Wizard, which changes the startup modules of your Backend users. After you have run through the Upgrade Wizards, you might want to change the startup module for the Backend users again.
Upgrading to 8.7 Long Term Support
Situation: You want to upgrade from version 7.6 LTS to 8.7 LTS
You need PHP 7 at least!
You must use TYPO3 7.6 or newer before you upgrade to TYPO3 8 LTS! Make sure that before you upgrade to TYPO3 8.7, you have run all Upgrade Wizards in TYPO3 7.6. Upgrade wizards from before 7.6 LTS are not available anymore in 8, which makes it impossible to update from a version older than TYPO3 7.6.
Note that this upgrade is faster than the upgrade to TYPO3 7.6!
An overview of all major changes in TYPO3 CMS is available in the new Upgrade Analysis section in the Install Tool.
- The system extension css_styled_content has been marked as deprecated and will be removed in TYPO3 CMS 9. Use fluid_styled_content instead! Migration hints...
- The old Rich Text Editor rtehtmlarea has been removed from the TYPO3 Core. Its replacement is rte_ckeditor. A tutorial on how to configure rte_ckeditor is available here. If you for now still want to continue using the old editor, you can use the Upgrade Wizard in the Install Tool to import it from TER.