Skip to main content
tinymash
  • Screen mode

Before importing

Treat an import as a content migration, not as a file upload. Source systems differ in how they represent dates, drafts, page hierarchy, images, links, summaries, and slugs.

Before the preview

  1. Create and verify a current backup.
  2. Decide whether the content belongs on the main site (Root) or in an author space.
  3. Create the target account before importing into an author space.
  4. Keep the account's sign-in disabled if the author space is intended as a locked section rather than a login account.
  5. Check the PHP upload and memory limits when using the browser.
  6. Use the CLI for large source files or long-running imports.

An inactive account remains a valid import target. Authors can import only into their own space; a superadmin can choose another permitted target.

Read the preview

Check at least:

  • post and page counts
  • published and unpublished counts
  • destination site or author space
  • duplicate or adjusted slugs
  • page parents and ordering
  • source dates
  • missing images or other media
  • any option that deletes existing target content

A preview does not reserve the target permanently. Content changed after preview can still cause a conflict when the import runs.

Replace options

Replace options delete all existing posts or pages of the selected type from the chosen site or author space before the first import batch. They do not limit deletion to matching URLs.

Leave replace options off when adding content to an existing site. With replacement off, existing entries are not overwritten; duplicate slug and type conflicts are skipped and reported.

Interrupted browser imports

Browser imports run in batches. If the session expires or a request is interrupted, sign in again, reopen the same preview, and choose Resume import.

Only one import can run for a destination at a time. Open the earlier import if it is still available. Release its lock only after that import has stopped. If a stopped import left a lock behind, clear it from the preview or use --force-lock in the CLI.

Temporary import workspaces normally expire after seven days of inactivity. --keep-preview retains a CLI preview until it is removed manually.