[00] Agencies
For client sites
If you build and look after WordPress sites for clients, this page covers what you'll want to know before you roll Subset out to many of them: how licences count, how to move work from staging to live, what you can script, and how your team shares one account.
How licences count across client sites
A licence covers 1, 5 or unlimited production sites. Most of the sites an agency touches in a week aren't production sites, and they don't count.
- Staging and local sites are free
localhost, private IP addresses,.localand.testdomains, DDEV and Lando addresses, your host's staging domain, andstaging.ordev.subdomains activate without using a slot, even when every paid slot is in use.- A multisite network is one site
- A network uses one slot however many subsites it has. A network administrator activates the key once, for the whole network.
- One slot per site, however many add-ons
- A bundle key covers every Pro add-on. Activate it in each add-on on a site, and that site still uses one slot.
- Hand a site back and free its slot
- Deactivating a site frees its slot at once. If you can't reach the old site any more, remove it from the Sites page in your account.
- A lapsed licence doesn't break a client's site
- We check the site limit when you activate, never while a site runs. If a licence expires, the free plugins keep working with their settings and data. Updates and support stop, and some Pro features pause.
Moving work from staging to live
Subset Sync pushes and pulls the database and media library between two WordPress sites, and rewrites URLs without breaking serialized data. Pro moves themes and plugins too.
- It backs up live first
- Before a push replaces live's database, Subset Sync backs it up on live. Restoring that backup undoes the push.
- It asks before it overwrites production
- Tick This is a production site on live, and a push asks you to type live's domain first. From WP-CLI, that's
--confirm-production=<domain>. - Live can keep its orders and comments
- Leave tables such as
commentsor WooCommerce's order tables out of a push, and live keeps its own copies.users,usermetaandoptionsare always pushed. - It replaces tables, it doesn't merge them
- A pushed table replaces live's copy whole, and rows that only live had in it are lost.
wp subset sync diffshows how far the two sites have drifted before you push.
Scripting it with WP-CLI
Every Subset plugin adds its commands under wp subset, so you can install, configure and check a client site from a shell or a deploy script.
- Install from a URL
wp plugin install https://subsetwp.com/download/redirects --activateinstalls a free plugin. Install Subset Installer the same way, andwp plugin updateupdates the rest.- Keys stay out of your shell history
- Each Pro add-on's
wp subset licensecommand reads the key fromSUBSET_LICENSE_KEYwhen you don't pass one. - Built for scripts
- Commands that change several things take
--dry-run. Commands that list things take--format=json. A command that fails exits with a non-zero status. - Start the next site from the last one
- Subset SEO and Subset Opt-Out export their settings as JSON and import them on another site. Subset Redirects imports and exports redirects as CSV.
- One subsite at a time
- On a network,
--urlpicks the subsite a command runs against.
Sharing the account with your team
Licences, sites and downloads belong to an account, not to one person, so your team can work from the same keys.
- Invite the people who set up sites
- Owners and admins invite colleagues as admins or members. Everyone in the account can see licence keys, activate and remove sites, and download the add-ons.
- Keep billing with the people who pay
- Only owners and admins can open billing and checkout, reissue a key, or change who's in the account.
- Work in more than one account
- If a client or another agency invites you to their account too, you switch between accounts from the header.
Compared with what you run now
Each comparison sets one Subset plugin against the plugin your client sites probably run now. Every row about the other plugin links to its source.
Ask us about your client sites
hello@subsetwp.comWrite before you buy if you're not sure how many slots a client list needs, or whether your host's staging domain is on our list.