Skip to content

[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

  1. Install the free plugin, then upload the Pro add-on from Plugins → Add New → Upload Plugin and activate it.
  2. Go to the plugin’s page under the Subset menu, for example Subset → Redirects, and open the License tab.
  3. 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:

CommandWhat it does
statusShows the saved licence as last checked, without contacting us
checkAsks us about the licence again, then shows it
deactivateFrees 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:

StatusWhat it meansWhat to do
Not activatedNo key is savedPaste your key
ActiveThe licence is active on this siteNothing
ExpiredThe licence term has endedRenew. See When a licence expires
Not active on this siteThe key is saved, but the site isn’t activated, for example after you removed it from your accountSelect Activate license again
No activations leftEvery site slot on the licence is in useFree a slot. See Moving a licence
DisabledThe licence was refunded, suspended or revokedContact us if you think it’s a mistake
InvalidA mistyped key, a key we don’t recognise, or a key for another pluginCheck 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.com and https://www.Example.com/ as one site, but example.com/blog is 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.com on port 443.