[00] Subset Sync, User guide
Themes, plugins and scheduled backups
What Subset Sync Pro adds. Push and pull themes and plugins, back up on a schedule, and convert between network types.
Subset Sync Pro is an add-on to the free Subset Sync plugin. It moves themes and plugins between sites, backs up your database on a schedule and converts between subdomain and subdirectory networks.
Install Pro
Pro needs the free Subset Sync plugin active, and WordPress 6.5 or newer.
- Download the Pro zip.
- Go to Plugins → Add New → Upload Plugin, upload it and activate it.
- Open Subset → Migration → Connection, enter your key in the License section and activate it.
An active licence gets updates and support. See activating a licence for what each status means.
For a theme or plugin transfer, both sites need Subset Sync and Pro.
Push and pull themes and plugins
- On the receiving site, open Connection and tick Accept theme and plugin files pushed from other sites. You only need this for a push.
- On the sending site, open the Themes & plugins tab.
- Choose Push or Pull, then pick the remote site.
- Under What to copy, tick Themes, Plugins or Must-use plugins. Click Choose one by one… to pick single packages.
- Click Preview, check the list of changes and confirm.
Must-use plugins are off by default, because hosts often install their own.
Each changed theme or plugin is staged in full and swapped in only when every one is ready, so neither site runs a half-copied plugin. If a transfer fails or you cancel it, the destination stays as it was.
A selected package ends up identical to the source’s copy. Packages that only the destination has are left alone. These are never copied: .git, .svn, .hg, node_modules, .DS_Store, symlinked packages, and Subset Sync and Pro themselves. Add more patterns under Exclude (one pattern per line).
Which plugins are active, and which theme is, lives in the database. Migrate the database to carry that across.
A site with DISALLOW_FILE_MODS set never accepts files, pushed or pulled. Replacing a production site’s files asks you to type its domain, the same as a database migration.
From the command line:
wp subset sync files push Staging
wp subset sync files push Staging --themes=my-theme --plugins=acme-blocks
wp subset sync files pull Production --plugins --dry-run
wp subset sync files allow --push=on
Scheduled backups
- Open Subset → Migration → Backups and scroll to Scheduled backups.
- Under How often, choose Twice a day, Daily or Weekly, and set the time.
- Set Scheduled backups to keep.
- Click Save schedule.
Click Back up now to take one straight away. Scheduled backups appear in the Backups list with the others, so you restore and download them the same way.
The time is in the site’s timezone. Backups start from WP-Cron, so on a quiet site a backup starts with the first visit after that time, unless a real cron job runs WP-Cron.
The keep number counts the backups taken before migrations too, and it’s never fewer than three. If a scheduled backup fails, the site admin gets an email. Untick Email the site admin when a scheduled backup fails to turn that off.
From the command line:
wp subset sync schedule set --every=daily --at=02:30 --keep=14
wp subset sync schedule status
wp subset sync schedule run
Convert between network types
With Pro, a push, pull or import can go between a subdomain network and a subdirectory network. Set up the destination as the other type first, with its own wp-config.php, rewrite rules and, for subdomains, wildcard DNS.
Each subsite takes the other type’s address. For example, shop.old.test becomes new.test/shop/. The main site and subsites on their own custom domain keep their addresses.
A subsite whose name doesn’t work in the other type is refused before anything changes. Examples are my_site, which isn’t a valid host name, and blog, which WordPress reserves as a path. Rename it first.
Settings that stay with each site
Pro’s licence, the backup schedule and each saved connection’s remembered selection stay with the site. A database push, pull, import or backup never carries them to another site.