Skip to content

Getting started

Migrator packs your WordPress database and wp-content files into a single self-hosted archive. You can restore it on the same site as a rollback point or migrate it to a fresh server.

  • WordPress 6.5 or newer
  • PHP 8.1 or newer
  • MySQL 5.7+ or MariaDB 10.4+
  • Recommended: tar or zlib PHP extensions for fast archive generation

Migrator operates entirely on your own server. It requires no third-party accounts, introduces no artificial file size caps, and transmits no site data outside your infrastructure unless you configure off-site storage.

  1. In wp-admin, navigate to Migrator > Backup.
  2. Select a backup preset:
    • Full site: Includes the complete database, plugins, themes, and media uploads.
    • Database only: Dumps tables without file assets (ideal for frequent backups).
    • Media only: Backs up uploads without database tables.
  3. Click Create backup now.
  4. Migrator processes the dump in chunked steps with a live progress bar. Once finished, the backup appears in your backup list.

Every backup is saved to wp-content/migrator-backups/ as a universal .tar.gz archive containing database.sql, manifest.json, and the archived wp-content directories.

To download:

  1. Go to Migrator > Backups.
  2. Locate the backup row.
  3. Click Download.

The download is served through an authenticated handler to administrators only. Because archives use standard .tar.gz formatting, you can inspect or extract them locally using standard desktop tools (tar, 7-Zip, Archive Utility) without needing the plugin.

A restore overwrites the selected site components with the state stored in the archive:

  1. Under Migrator > Backups, click Restore on the target archive.
  2. Select which components to bring back:
    • Database: Restores tables and content.
    • Plugins: Replaces /wp-content/plugins/.
    • Themes: Replaces /wp-content/themes/.
    • Uploads: Restores media files.
  3. Confirm the action. Before writing any table data, Migrator takes an automatic pre-restore database snapshot to safeguard your current state.

On environments with DISALLOW_FILE_MODS enabled, wp-admin restores are limited to the database and uploads. Code files (plugins and themes) must be restored via WP-CLI:

Terminal window
wp migrator import path/to/backup.tar.gz --only=plugins,themes

Moving an existing site to a new domain or host requires three steps:

  1. Export: On the original site, create and download a Full site backup.
  2. Setup: Install a clean WordPress instance on the new server and activate the Migrator plugin.
  3. Import: Open Migrator > Restore, upload the .tar.gz file, and proceed with the restore.

During database extraction, Migrator detects domain and directory path changes between the source and destination. It performs a serialization-safe URL and path rewrite, preserving byte counts inside serialized arrays and options so widgets, menus, and plugin settings remain intact.