Importing .t3d files in the TYPO3 backend
The import functionality is only available for admin users and Backend users for which the Page TSconfig option options.impexp.enableImportForNonAdminUser has been enabled.
Table of contents
Note
Make sure that any required extensions are installed and the database schema is up-to-date before starting the import. Otherwise, the data related to non-existing tables will not be imported.
Open the import module
In the page tree, right-click the page you want to import to (1) and select More options ... > Import (2).
Select "More options... > Import"
Upload the export file
On the second tab of the import module you can upload the export file to your target TYPO3 instance.
Select the file to upload (1) and click the Upload files button (2).
Then switch to the Import tab (3).
Upload the export data
Configure the import settings
On the first tab of the import module you can configure the import.
First select the uploaded export file (1). Then adjust the general settings (2). Finally, press the Preview button (3).
- Checking Update records means that existing records with the same UID will be updated instead of newly inserted.
- Checking Do not show differences in records prevents calculation of differences between existing and imported records. Note: The compare function is currently broken and therefore disabled in the screenshot.
Configure the import
Review the data to be imported
A tree with the records to be imported is displayed below the configuration form (1). If you change any of the options (2), you can reload this preview with the Preview button (3).
Check and perform the import
If the export file contains site configurations, they are listed below the meta data in the section Site Configurations. For each site the preview shows the identifier, the title of the root page, the website title, the dependencies and the languages.
Site configurations are only imported for administrators. Other backend users see a warning that the embedded site configurations are skipped.
Execute the import
Click the Import button to execute the import process.
Import of site configurations
Embedded site configurations are written after all records have been imported. For each of them:
- The root page is replaced by the UID of the imported page.
- If the imported root page already has a site configuration, the embedded one is skipped.
- If the site identifier is already used by another site, a numeric
suffix is appended, for example
my-.site- 1 - The base of the site is set to
/<identifier>/, using the final identifier. Adjust it in the site management afterwards. - If the configuration cannot be written, the import continues without it and does not report an error.
Page UIDs that are referenced elsewhere in the configuration, for example in error handling or routes, are not remapped. Review the imported site configuration in the Sites module.
Note
If an extension ships both an import file and an Initialisation/
folder, the site configurations embedded in its import file are not
imported during the extension initialization. The ones in
Initialisation/ are used instead.