[00] Licences and sites, User guide
Activating a licence
Where the licence key goes, what it looks like, what each status on the License tab means, and what your site sends us.
A licence key activates a Pro add-on on your site. This page covers where to find the key, where to paste it, what each status means and what your site sends us. The free plugins never ask for a key, so if you only use a free plugin, you can skip this page.
Find your key
We email your key when you buy. You can also find it in your account: open Licences, choose the licence and select Show key. It looks like this:
subset_BVVRMRVPNMP4DA5BVMNYAUMVQKG7FBNR
A key is subset_ followed by 32 characters. Keys never contain 0, 1, I, L or O, so you can’t confuse one letter for another.
The last character is a check character, worked out from the rest of the key. It catches a single mistyped character or two swapped neighbours before anything is sent, so a typo shows as Invalid straight away.
You can paste the key however it arrives. Upper or lower case, spaces at either end, and spaces, hyphens or underscores in the middle are all fine.
Activate it
- Install the free plugin, then upload the Pro add-on from Plugins → Add New → Upload Plugin and activate it.
- Go to the plugin’s page under the Subset menu, for example Subset → Redirects, and open the License tab.
- Paste your key into License key and select Activate license.
Subset Sizes’ buttons are labelled Activate and Deactivate on this site. Subset Sync keeps its licence in a License section on the Connection tab.
The tab then shows the status, the key with all but its last four characters hidden, and the expiry date. Your account shows how many of the licence’s sites are in use.
If you have a bundle, paste the same key into each Pro add-on’s License tab. All the add-ons on one site share the same site address and install ID, so the site uses one slot however many add-ons you activate.
On a multisite network, only network administrators see the License tab, and one activation covers the whole network. See Multisite networks.
Activate from WP-CLI
Each Pro add-on adds a wp subset license <product> command:
wp subset license redirector activate subset_BVVRMRVPNMP4DA5BVMNYAUMVQKG7FBNR
To keep the key out of your shell history, leave it off and set SUBSET_LICENSE_KEY instead:
SUBSET_LICENSE_KEY=subset_… wp subset license redirector activate
The product names are image-resizer, cookie-manager, content-builder, redirector, duplicator, migration and seo. The other subcommands are:
| Command | What it does |
|---|---|
status | Shows the saved licence as last checked, without contacting us |
check | Asks us about the licence again, then shows it |
deactivate | Frees this site’s slot and removes the key from the site |
status and check take --format=table, json or yaml.
What each status means
The License tab shows one of these:
| Status | What it means | What to do |
|---|---|---|
| Not activated | No key is saved | Paste your key |
| Active | The licence is active on this site | Nothing |
| Expired | The licence term has ended | Renew. See When a licence expires |
| Not active on this site | The key is saved, but the site isn’t activated, for example after you removed it from your account | Select Activate license again |
| No activations left | Every site slot on the licence is in use | Free a slot. See Moving a licence |
| Disabled | The licence was refunded, suspended or revoked | Contact us if you think it’s a mistake |
| Invalid | A mistyped key, a key we don’t recognise, or a key for another plugin | Check the key against your purchase email. A single-plugin licence covers only that plugin |
If the tab says the licence server couldn’t be reached, nothing has changed on your licence. The tab keeps the last status it had. Check that the site can make outgoing connections and try again in a few minutes.
Staying up to date
Once a day, each add-on asks us whether its licence is still active, so a renewal or a refund shows up on its own. Select Check again on the License tab, or run wp subset license <product> check, to ask straight away.
If your site can’t reach us, the add-on keeps the last status it saw.
What leaves your site
The add-on contacts api.subsetwp.com when you activate or deactivate, once a day for the licence check, and when WordPress checks for plugin updates. Each request contains:
- your licence key
- your site address
- a random ID for the install, shared by every Subset add-on on the site
- the product name and the add-on’s version
- on activation and update checks, your WordPress and PHP versions and whether the site is a multisite network
Nothing else is sent. No post content, user data or visitor data, and nothing on page load.
If the key won’t activate
- Check the plugin. A single-plugin licence covers only that plugin. The bundle covers every Pro add-on.
- Check the site address. We treat
example.comandhttps://www.Example.com/as one site, butexample.com/blogis a different install. See What counts as a site. - Check outbound HTTPS. Some hosts block outgoing requests from PHP. The add-on needs to reach
api.subsetwp.comon port 443.