WP-CLI Complete Guide: WordPress Command Line Interface 2026

What is WP-CLI and Why Developers Rely on It

WP-CLI (WordPress Command Line Interface) is a command-line tool that lets you manage WordPress through a Terminal or SSH shell instead of the WordPress Admin Panel. This means you can install plugins, delete websites, change URLs across the entire database, and manage WordPress at a deeper level—all without ever touching the WordPress dashboard. It's a tool that gives you direct access to WordPress functionality at the command level.

The major advantage of WP-CLI is speed and efficiency. It operates 10 times faster than the Admin Panel because it doesn't need to load HTML, CSS, JavaScript, or images. If you need to update 50 plugins, WP-CLI can complete the task in 10 seconds—the Admin Panel might take 5-10 minutes. For developers and system administrators managing multiple WordPress sites, WP-CLI is indispensable.

Developers, system administrators, and advanced site managers use WP-CLI constantly because it enables batch operations—handling large numbers of tasks at once. Whether it's finding and replacing URLs across an entire database, extracting WordPress configuration reports, or backing up databases at scale, WP-CLI handles these jobs quickly and efficiently without relying on plugins or your hosting control panel.

Installing WP-CLI on Linux VPS with DirectAdmin

WP-CLI doesn't come pre-bundled with WordPress or DirectAdmin. You'll need to install it yourself on your server via SSH. The process is straightforward and takes only 1-2 minutes.

Step 1: SSH into Your VPS

First, SSH into your server using an SSH client (PuTTY, Terminal, or iTerm) as the root user or a user with sudo privileges.

ssh root@[your-vps-ip] or ssh [username]@[your-vps-ip]

Step 2: Download and Install WP-CLI

Run the following commands to download WP-CLI and place it in /usr/local/bin/:

• 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

Step 3: Verify Installation

Run wp --version to confirm WP-CLI installed successfully. You should see output like WP-CLI 2.10.0.

Basic WP-CLI Commands — Install, Update, and Manage WordPress

Once WP-CLI is installed, you can use numerous commands to manage WordPress. The following are the most commonly used ones.

WordPress Core Commands

These commands manage the WordPress Core (WordPress itself):

• wp core version — View your current WordPress version
• wp core update — Update WordPress to the latest version
• wp core update-db — Update the WordPress database after a core update
• wp core verify-checksums — Verify that WordPress core files haven't been altered (useful for hacking detection)
• wp core config — Auto-generate wp-config.php

Plugin Commands

These commands handle plugin management:

• wp plugin list — List all plugins with their status (Active/Inactive)
• wp plugin install hello-dolly — Install a plugin (name must match the repository)
• wp plugin activate hello-dolly — Activate a plugin
• wp plugin deactivate hello-dolly — Deactivate a plugin
• wp plugin delete hello-dolly — Remove a plugin
• wp plugin update --all — Update all plugins at once
• wp plugin search woocommerce — Search for plugins in the WordPress repository

Theme Commands

These commands manage your themes:

• wp theme list — List all installed themes
• wp theme install twentytwentyfour — Install a new theme
• wp theme activate twentytwentyfour — Activate a theme
• wp theme update --all — Update all themes
• wp theme delete twentytwentythree — Remove an unused theme

User Commands

These commands manage WordPress users:

• wp user list — List all users
• wp user create username [email protected] --role=editor — Create a new user with a specific role
• wp user delete username — Remove a user
• wp user set-role username administrator — Change a user's role
• wp user list --field=user_login — Display only usernames

Search-Replace — Change URLs When Migrating

One of the most useful WP-CLI commands is wp search-replace, which finds and replaces text across your entire WordPress database instantly. This is incredibly valuable when migrating WordPress from an old domain to a new one.

Example: Change Home URL from old-domain.com to new-domain.com

wp search-replace 'https://old-domain.com' 'https://new-domain.com'

This command instantly scans the database for the old URL (in posts, pages, and embedded links) and replaces all instances with the new URL—something that would take Plugin searches or manual database edits with the Admin Panel.

Other Examples

• wp search-replace 'oldtext' 'newtext' — Find and replace plain text
• wp search-replace 'old' 'new' --dry-run — Test the replace without saving changes
• wp search-replace 'old' 'new' --global-tables — Perform search-replace across all WordPress tables (for Multisite)

Database Backup — Export and Update Your Database

WP-CLI includes simple commands to backup and restore your WordPress database—essential before making any changes to WordPress.

Export Database to a SQL File

wp db export /home/backups/wordpress-backup-$(date +%Y-%m-%d).sql

This exports your WordPress database to a SQL file in /home/backups/ with a date-stamped filename (e.g., wordpress-backup-2026-06-21.sql).

Import Database from a SQL File

wp db import /home/backups/wordpress-backup-2026-06-21.sql

This restores your database from a backed-up SQL file.

Other Database Commands

• wp db show-tables — List all database tables
• wp db query "SELECT COUNT(*) FROM wp_posts" — Run custom SQL queries
• wp db repair — Repair a corrupted database
• wp db optimize — Optimize database (defragmentation)

Cron Jobs — Schedule Automated Tasks

WordPress has a built-in cron system for scheduled tasks (auto-updates, backups, cleanup, etc.). WP-CLI lets you test and manage these easily.

List Scheduled Events

wp cron event list

This shows all scheduled WordPress events and when they'll run next.

Run a Scheduled Event Immediately

wp cron event run wp_scheduled_auto_core_update

Useful for testing cron jobs without waiting for the scheduled time.

Multisite Commands — Managing WordPress Multisite

If you run WordPress Multisite (multiple sites sharing one WordPress install), WP-CLI provides dedicated commands.

Multisite Commands

• wp site list — List all sites in your Multisite network
• wp site create --slug=newsite --title='New Site' — Create a new site
• wp site delete 2 — Delete a site (by ID)
• wp site empty 2 — Delete a site's content while keeping the database
• wp site list --field=domain — Show only domain names

Batch Operations — Handle Large Tasks at Scale

WP-CLI's real power shines in batch operations—performing many tasks simultaneously through shell scripting.

Example: Delete All Posts

wp post delete $(wp post list --post_type=post --format=ids) --force

This finds all post IDs and deletes them in one command—something Admin Panel would require clicking through manually.

Example: Activate All Plugins

wp plugin activate --all

Example: Update Everything at Once

wp core update && wp plugin update --all && wp theme update --all

WP-CLI vs WordPress Admin Panel — Speed Comparison

Here's a speed comparison between WP-CLI and the Admin Panel for common tasks:

As you can see, WP-CLI is 20-100x faster than the Admin Panel depending on the task—especially for batch operations. WP-CLI is also more reliable and won't timeout or require page refreshes like the browser-based Admin Panel.

Shell Scripts — Automate Your Workflows

You can create Bash shell scripts to automate WP-CLI commands. For example:

Example: Daily Backup Script

#!/bin/bash
DATE=$(date +%Y-%m-%d)
wp db export /home/backups/wp-backup-$DATE.sql
echo "Backup completed: /home/backups/wp-backup-$DATE.sql"

This script creates a daily database backup. Schedule it as a Cron job to run automatically at a specific time (e.g., 2 AM daily).

Example: Major Update Script

#!/bin/bash
wp plugin update --all
wp theme update --all
wp core update
wp core update-db
echo "WordPress updated successfully"

This updates everything safely, including the database.

Pros and Cons of WP-CLI

WP-CLI is powerful, but it's not for everyone. Here's what you should know:

Advantages

• Speed: 10-100x faster than the Admin Panel
• Batch Operations: Handle many tasks simultaneously
• Automation: Create scripts for automatic processing
• Remote Management: Manage WordPress from anywhere via SSH
• Free and Open Source: No licensing costs
• Official Support: Developed and backed by Automattic (WordPress.com team)

Disadvantages

• Requires SSH Access: Some shared hosting doesn't provide this
• Steep Learning Curve: Requires command-line familiarity
• Manual Installation: Doesn't come pre-installed with WordPress
• No GUI: You must memorize commands—no visual interface
• Error-Prone: Incorrect commands could damage your site