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.

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"

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

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

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

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.