Overview
Burst Statistics registers a burst command group with WP-CLI, the command-line interface for WordPress. Use it to manage settings, goals and data in automated deployment pipelines, staging environments and CI workflows without touching the admin dashboard.
Requirements
- WP-CLI 2.x or later
- PHP 7.4 or later
- WordPress 5.5 or later
- Burst Statistics (Free or Pro) installed and active
Installing WP-CLI
If WP-CLI is not already available on your server, follow the official installation guide. Most managed hosting environments include WP-CLI by default; check your host's documentation.
Quick install on Linux / macOS:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
Verify:
wp --info
Command syntax
All Burst commands follow the standard WP-CLI pattern:
wp burst <command> [<args>] [--<assoc_arg>=<value> ...]
Command reference
| Command | Description | Free / Pro |
|---|---|---|
add_goal | Add a new conversion goal | Free |
save | Update one or more plugin options | Free |
install_demo_data | Populate the database with demo statistics | Free |
reset_data | Delete all statistics data and reset to defaults | Free |
activate_license | Activate a Burst Pro license key | Pro |
deactivate_license | Deactivate a Burst Pro license key | Pro |
unzip | Extract a ZIP archive using the WordPress Filesystem API | Free |
send_test_telemetry | Send a test telemetry payload (test environments only) | Free |
get_internal_links | Output all internal admin URLs found in the source (test environments only) | Free |
Useful global flags
These are standard WP-CLI flags that work with all wp burst commands:
| Flag | Description |
|---|---|
--path=<path> | Path to the WordPress installation. Useful when running WP-CLI outside the webroot |
--url=<url> | Site URL. Required on multisite to target a specific subsite |
--user=<user> | Run the command as a specific WordPress user (ID, login or email) |
--quiet | Suppress informational output. Useful in deployment scripts where only errors matter |
--format=json | Return output as JSON where supported |
--skip-plugins | Load WordPress without activating plugins. Use with care — Burst commands require Burst to be active |
Further reading
- WP-CLI official documentation
- WP-CLI commands cookbook — how commands are built
- Using WP-CLI with cron and deployment — config file reference for multi-environment setups