Export and import Expert content and data

Last updated
Save as PDF

Applies to:: MindTouch (current)
Role required:: Admin

Use the Import and Export Tool or the API to export and import contents between Expert sites.

Content import and export

Prerequisites

Ensure you can access the relative URL /Special:ImportExport on your site. If you see "You do not have permission to view this page" then Contact Support to enable the tool for your site.

Export

Navigate to the relative URL /Special:ImportExport on the site you would like to export.
Enter an email address, select desired hierarchy, and click Export.
Wait for the export to finish, which may take several hours.
The Jobs table shows a status percentage until the job is finished.
When the export is finished, the Status column will show Completed.
Links to Export Warnings Download and Download [Site Name] Site Export will be sent from no-reply@mindtouch.usto the email address specified for the export.

If an export is needed for systems besides Expert, see Site Export Details.

Import

Mac users: If you downloaded the export file and are zipping the file back up to upload to import, and you are using a Mac, you must open the unzipped file, select all of the file's content, and zip those into a new folder. Failure to do this will result in a failed import.

Navigate to the relative URL /Special:ImportExport on the site you would like to import.
Select the Import tab.
Enter an email address.
Enter a URL for your uploaded archive into the URL of archive to import field. The archive file URL must be hosted in a publicly accessible location that the import tool servers can access.
If you want to test the import file, select the Test import.
1. Your archive will not be imported, but you will receive an email that includes a header confirming Import Test Run Complete or Import Test Run Failed and a CSV attachment containing a detailed list of errors.
Click Import.
If either the Import or the Test Import fails, check the Warnings Log that will be sent to the email address specified for the import from no-reply@mindtouch.us.

API method

Use API calls to automate import and export functions in your site:

Export content

Export content: site/jobs/export (POST)

Import content

Import content: site/jobs/import (POST)

Status

Return all recent jobs: site/jobs (GET)
Return job status: site/jobs/{id}/status (GET)

Find page

Search content by tag, classification, or last modified time stamp: pages/find (GET)

Tips & Troubleshooting

All exports and imports have a run-time limit of 11.5 hours and requests that exceed 11.5 hour run-time will auto-cancel.
If an export or import doesn't complete within 11.5 hours, we recommend separating it into smaller sections.
If an export or import doesn't progress after an hour, we recommend separating it into smaller sections.
If your site contains more than 75k pages, we recommend separating it into smaller sections.
If your site contains more than 100k pages, you must separate it into smaller sections or the job will fail.
All exports include templates, which can potentially overwrite Headers and other customizable templates on the Expert site you are importing to.