License commands
ProAvailable in Burst Pro
These commands require Burst Pro to be installed and active.
Commands for managing a Burst Pro license key from the command line. Useful for automated provisioning, server migrations and multisite deployments where using the dashboard for each site is impractical.
activate_license
Activates a Burst Pro license key on the current site. The key is validated against the licensing server and stored locally.
Usage:
wp burst activate_license <license_key>
Arguments:
| Argument | Type | Required | Description |
|---|---|---|---|
<license_key> | string | Yes | The Burst Pro license key to activate |
Output:
Success: License activated
Example:
wp burst activate_license XXXX-XXXX-XXXX-XXXX
Activating on multisite
On WordPress multisite, a license key is typically activated once per subsite. Target a specific subsite with --url:
wp burst activate_license XXXX-XXXX-XXXX-XXXX --url=https://subsite.example.com
Repeat for each subsite that requires Pro features. Check your license terms for the number of activations allowed.
Activating in a deployment pipeline
Show code
#!/usr/bin/env bash
set -e
wp plugin activate burst-statistics-pro --quiet
wp burst activate_license "${BURST_LICENSE_KEY}" --quiet
echo "Burst Pro activated."
Store the license key in a CI/CD secret or environment variable (BURST_LICENSE_KEY) rather than hardcoding it in scripts.
deactivate_license
Deactivates the Burst Pro license key on the current site. This frees up an activation slot so the key can be used on a different site. Run this before decommissioning or moving a site.
Usage:
wp burst deactivate_license <license_key>
Arguments:
| Argument | Type | Required | Description |
|---|---|---|---|
<license_key> | string | Yes | The Burst Pro license key to deactivate |
Output:
Success: License deactivated
Example:
wp burst deactivate_license XXXX-XXXX-XXXX-XXXX
Deactivating before site removal
If you are deleting or archiving a site, deactivate the license first to recover the activation slot:
wp burst deactivate_license XXXX-XXXX-XXXX-XXXX --quiet
wp plugin deactivate burst-statistics-pro --quiet
Troubleshooting
"License key not found" error Confirm the key is correct and has not already been deactivated. Log in to your Burst account dashboard to check active sites and remaining activation slots.
Activation fails in a firewall-restricted environment License activation requires an outbound HTTPS connection to the Burst licensing server. If your server blocks outbound requests, allowlist the licensing endpoint domain or activate via the dashboard from a machine with unrestricted access.