WP-CLI is a way to manage WordPress from the command line (a terminal) instead of clicking through the dashboard. If you or your host use it, WP PowerSuite adds a set of wp powersuite commands for the same things you’d normally do in WP PowerSuite -> Modules and its tools - checking your setup, turning modules on and off, saving your settings, clearing caches, cleaning the database, managing redirects, finding broken links, and creating backups.
Everything here is optional. If you manage a single site from wp-admin, you never need to open the command line.
Is this for me?
Section titled “Is this for me?”WP-CLI is aimed at developers, agencies, and anyone who automates WordPress. It is handy when you want to:
- Set up new sites the same way every time.
- Manage many sites without logging into each dashboard.
- Add WP PowerSuite steps to a deployment or maintenance script.
Before you start
Section titled “Before you start”- Your server or host needs WP-CLI installed. Most managed WordPress hosts include it - ask your host if you are not sure.
- WP PowerSuite must be active on the site.
- Running several sites on one WordPress install (multisite)? Add
--url=https://example.comto any command to point it at one site.
To confirm the commands are available:
wp powersuite statuswp help powersuiteThe first command prints a quick summary of your site. The second lists every command WP PowerSuite adds.
A note on access
Section titled “A note on access”What you can do
Section titled “What you can do”Check your setup
Section titled “Check your setup”wp powersuite status [--format=table|json|yaml]Prints a summary of your site: plugin, WordPress, and PHP versions, your license status, how many modules are on, and other basics. Nothing sensitive is shown.
Turn modules on and off
Section titled “Turn modules on and off”wp powersuite module list [--enabled] [--disabled] [--category=<name>]wp powersuite module get <module-name>wp powersuite module enable <module-name>... [--all] [--include-sensitive]wp powersuite module disable <module-name>... [--all]enableanddisableare safe to run again - if a module is already in the state you asked for, nothing breaks.- Pro modules need WP PowerSuite Pro installed and an active license.
--allturns on the everyday modules but skips the sensitive ones (like changing your login address, maintenance mode, or email delivery) unless you add--include-sensitive.- WP PowerSuite runs the same safety checks as the dashboard, so it will not switch on something that clashes with a module you already have active.
# Turn on two modules at oncewp powersuite module enable redirect-manager broken-link-checker
# See which modules are currently onwp powersuite module list --enabledSave and load your settings
Section titled “Save and load your settings”wp powersuite settings export [--file=<file>]wp powersuite settings import <file> [--dry-run] [--replace]Save all of your WP PowerSuite settings to a file, then load them onto another site or keep the file as a backup.
- Exported files never include secrets like license keys or passwords.
- Add
--dry-runto preview an import without changing anything. - Imports are merged with your current settings by default. Add
--replaceto overwrite them instead.
Clear caches
Section titled “Clear caches”wp powersuite cache clear [--all]Clears WP PowerSuite’s own temporary data. Add --all to also clear WordPress’s full cache for the whole site - you will see a warning first.
Clean up the database
Section titled “Clean up the database”wp powersuite database cleanup [--dry-run] [--include-caution] [--yes]Removes clutter that WP PowerSuite can safely clean up. Use --dry-run to see what would be removed without deleting anything. More aggressive tasks only run when you add --include-caution, and deleting asks for confirmation (or add --yes for unattended runs).
Find broken links
Section titled “Find broken links”wp powersuite broken-links scan [--post-type=<types>] [--limit=<number>]wp powersuite broken-links statusScans your posts and pages for links that no longer work and prints a report. status tells you whether a scan is already running.
Manage redirects
Section titled “Manage redirects”wp powersuite redirects listwp powersuite redirects export <file>wp powersuite redirects import <file> [--dry-run]List, export, and import your redirects as a CSV file. Rows that are invalid or duplicated are skipped, and --dry-run lets you preview an import before it is saved.
Create backups
Section titled “Create backups”wp powersuite backup create [--type=full|database|files] [--label=<label>]wp powersuite backup listCreates a full, database-only, or files-only backup - the same kind your scheduled backups make.
Run scheduled tasks
Section titled “Run scheduled tasks”wp powersuite cron listwp powersuite cron run <task>Lists the background tasks WP PowerSuite schedules, and lets you run one right away. Only WP PowerSuite’s own tasks are affected.
Using commands in scripts
Section titled “Using commands in scripts”- Every command reports success or failure, so it fits neatly inside deployment or maintenance scripts.
- Add
--format=jsonwhen another program needs to read the output. - For unattended runs, use
--dry-runto preview and--yesto skip confirmations.
Modules with their own commands
Section titled “Modules with their own commands”Every module can be turned on or off by name (wp powersuite module enable|disable|get <module-name>). A few modules add extra commands of their own:
- Redirect Manager -
wp powersuite redirects ... - Broken Link Checker -
wp powersuite broken-links ... - Database Cleanup -
wp powersuite database cleanup ... - Backup & Restore -
wp powersuite backup ...
Do I need to install anything to use these commands?
No. As long as WP-CLI is installed on your server and WP PowerSuite is active, the wp powersuite commands are ready to use. Type wp powersuite status to check.
Do the commands work if I run several sites on one install?
Yes. On a WordPress multisite network, add --url=https://example.com to any command to point it at one site.
Will my license key or passwords show up in the output?
No. WP PowerSuite hides secrets such as license keys, API keys, and passwords from the status output and from exported settings files.
Which modules have their own commands?
Redirect Manager, Broken Link Checker, Database Cleanup, and Backup & Restore. Every other module is turned on or off with wp powersuite module enable, disable, or get followed by its name.
Can I restore a backup from the command line?
No. For safety, restoring a backup is only available in the dashboard, where there are extra confirmation steps.