How to Use WP-CLI to Manage a WordPress Multisite Network

WP-CLI lets you install or convert a WordPress multisite network, target an individual site, create and inventory sites, manage their lifecycle, administer super administrators, and perform maintenance from a shell. The reliable pattern is to set --path to the WordPress files, use --url for the site context, and add --ssh when the files and database are on another server or container.

Antihost offers managed WordPress hosting with free migration, one-click staging and a 14-day free trial.

This guide covers a new network, conversion of an existing installation, subdomain and subdirectory layouts, local and remote execution, site and network administration, migration safeguards, and recovery from common failures.

#	Preview	Product	Price
1		Gaoye Blue Light Blocking Glasses	$9.99	Buy on Amazon
2		Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and...	$6.59	Buy on Amazon
3		LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men	$9.99	Buy on Amazon
4		Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack	$9.99	Buy on Amazon
5		HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″...	$59.98	Buy on Amazon

As an Amazon Associate I earn from qualifying purchases.

What WP-CLI manages in a multisite network

WP-CLI is the official command-line tool for interacting with and managing WordPress sites. In multisite mode, one WordPress codebase serves a network of sites that share core files and a database installation while retaining site-specific content, options, users and permissions. A shell is useful because the same operation can be repeated consistently across many sites and scheduled in deployment or maintenance scripts.

The most important distinction is scope. Some commands operate on the network as a whole; others operate on the site selected by the command’s URL context. A command that is safe for one site can be disruptive when run against the network’s default site, so make the target explicit before changing data.

#1 Best Overall

Sale

Gaoye Blue Light Blocking Glasses

• BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
• EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
• COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
• LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
• WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

$9.99

Buy on Amazon

Preflight checks before enabling multisite

Multisite changes database structure and configuration. Take a database backup and a copy of the WordPress files before either installation or conversion. Confirm that the shell user can read the WordPress directory, write wp-config.php when the command must modify it, and connect to the database defined by that configuration.

• Record the absolute WordPress directory for use with --path=<path>.
• Decide whether new sites will use subdomains (for example, store.example.com) or subdirectories (for example, example.com/store).
• For a subdomain network, make sure DNS and the web server can resolve the intended subdomains. A wildcard DNS record and matching virtual-host configuration are commonly required, but the exact setup depends on the host.
• For Apache, plan to update .htaccess with the multisite rewrite rules printed by the documentation after installation or conversion.
• Check that the PHP, database and WordPress versions meet the requirements of the WordPress release you are running. WP-CLI’s command reference is regenerated at every release, so option availability can change.
• Use a maintenance window for conversion or large migrations. Do not run database replacements while application writes are occurring unless you have a tested, coordinated procedure.

Choose a new network or a conversion

Do not use the conversion command on a disposable copy and assume it will automatically redesign URLs, DNS or web-server routing. It changes the WordPress installation; the surrounding server and DNS still need to serve every site address.

Install a new multisite network with WP-CLI

1. Run the documented network installation command

From the directory containing (or by pointing to) the WordPress files, provide the network URL, base path, network title and administrator details. A subdomain network adds --subdomains; omit that flag for a subdirectory network.

wp core multisite-install 
  --url=https://example.com 
  --base=/ 
  --title="Example Network" 
  --admin_user=networkadmin 
  --admin_password='use-a-long-unique-password' 
  [email protected] 
  --subdomains

Use the actual scheme and host that visitors will use. If the network is intended to live below a path, set --base to that path rather than assuming a root installation. Keep administrator credentials out of shell history where your environment exposes them; use your platform’s secure secret handling or an interactive approach when available.

2. Verify the generated configuration

The command creates the network tables and adds the multisite constants to wp-config.php. Inspect the file and confirm that the values match the chosen URL structure. A command can complete successfully while a file permission policy prevents a later web request from reading the expected configuration, so test a browser request and a WP-CLI request.

3. Apply web-server rewrites

Apache users must update .htaccess with the appropriate multisite rewrite rules. The exact block depends on whether the network uses subdomains or subdirectories and on the installation path. Copy the rules shown by the current WordPress/WP-CLI documentation rather than reusing a block from another layout. Reload or restart the web server if its configuration requires it.

4. Confirm the network from the command line

wp site list --field=url

The output should include the initial site URL. If this command reports that WordPress is not found, add --path=/absolute/path/to/wordpress; if it connects to the wrong site context, add an explicit --url.

Convert an existing single-site installation

1. Back up and identify the current site

Conversion preserves the existing site’s content but changes the installation into a network. Capture a database dump, the uploads directory and configuration. Note the current canonical URL, because it becomes the network’s primary site unless you deliberately change it later.

Rank #2

Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)

• WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
• AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
• PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
• ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
• COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

$6.59

Buy on Amazon

2. Run the conversion command

wp core install-network 
  --path=/var/www/example 
  --url=https://example.com

wp core install-network is an alias for wp core multisite-convert. If your local version exposes only the alias, run the equivalent command shown by wp help core install-network or wp help core multisite-convert.

3. Finish the server-side conversion

The command creates multisite database tables and writes the required constants. For Apache, update .htaccess with the appropriate multisite rewrite rules; the conversion is not complete until requests are routed under the new rules. Verify login, the existing site’s front end, uploads and an administrative command before creating additional sites.

Choose subdomains or subdirectories deliberately

The choice affects every later URL, migration and redirect. Decide it before installation when possible. If a requirement changes later, treat the change as a URL migration: inventory stored URLs, back up, run a dry run, and test redirects and media rather than simply editing one option.

Target the correct site and server

Use --path for the WordPress files

When your current directory is not the WordPress root, point WP-CLI at it explicitly:

wp --path=/var/www/network core version

The global option applies to the command that follows. It prevents an accidental connection to another WordPress installation on the same host.

Use --url for site context

In a multisite installation, the global --url=<url> parameter selects the site context. Combine it with the path when operating from a neutral directory:

wp --path=/var/www/network --url=https://example.com/store option get blogname
wp --path=/var/www/network --url=https://example.com/store plugin list

The first command reads the selected site’s name; the second lists plugins in that site’s context. Without --url, commands that require a site may use the network’s default site, which is rarely what you want in a loop.

Run against a remote host or container with --ssh

The global SSH form is --ssh=[<scheme>:][<user>@]<host|container>[:<port>][<path>]. It executes WP-CLI where the WordPress files and database are available:

Rank #3

Sale

LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men

• Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
• Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
• Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
• ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
• Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

$9.99

Buy on Amazon

wp [email protected]/var/www/network 
  --url=https://example.com/store site get 3

Use the SSH user, host, port and remote path appropriate to your environment. Authentication, host-key verification and the remote PHP/WP-CLI installation are prerequisites; a successful SSH connection alone does not prove that the remote command can reach the database. Test with a read-only command such as core version or site list --field=url first.

Save repeated targets as aliases

WP-CLI aliases in wp-cli.yml let you name environments and avoid repeatedly typing paths or SSH destinations. Keep credentials and private host details protected, and verify an alias with a harmless command before using it in a script. The live command reference documents the supported alias syntax for your installed version.

Inventory sites and create new ones

List every site URL

wp site list --field=url

--field=url emits one URL per line, which is convenient for review or for feeding a carefully tested loop. The wp site list command also supports network and site-ID filters. Use wp help site list to see the exact filter names and output fields available in your installed release.

Create a site

The documented basic example is:

wp site create --slug=example

A successful run reports the new numeric site ID and URL, for example, “Success: Site 3 created: www.example.com/example/”. The slug’s meaning depends on the network model:

• On a subdomain network, use a subdomain slug such as store, or supply the complete address with --site-url.
• On a subdirectory network, use a path slug such as store, or supply the complete address with --site-url.

After creation, query the returned site ID and URL, then use that URL with --url for site-specific configuration. Creating a site does not automatically create DNS records, TLS certificates, custom content or a new administrator account.

Manage the site lifecycle

The wp site command group contains separate operations for availability, visibility, moderation and deletion. Use the site’s URL or ID to identify the target and confirm the result with a read-only query.

Protect destructive commands

Do not substitute empty for delete or assume that archiving is a backup. Export or snapshot the relevant database and uploads, record the site ID, and perform a dry or read-only check where the command supports one. In scripts, print the resolved URL and ID before invoking an irreversible operation, require an explicit confirmation variable, and stop on a non-zero exit status.

Administer the network and its super administrators

Manage network metadata

wp network meta gets, adds, updates, deletes and lists custom fields stored for the network. It is appropriate for network-level metadata, not for a site’s ordinary options. Inspect existing keys before changing them so that a new value does not silently conflict with a plugin or deployment process.

Rank #4

Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack

• Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
• Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
• 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
• Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
• USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

$9.99

Buy on Amazon

Grant and revoke super-administrator access

The super-admin commands manage network-wide administrator membership:

wp super-admin list
wp super-admin add username
wp super-admin remove username

The quick-start handbook specifically recommends wp super-admin add to grant super-admin capabilities to an existing user on multisite. Use an existing account, confirm its identity, and keep membership to the smallest group that needs network-wide access. A super administrator can affect every site, so record additions and removals in your change log.

Change settings for one site without affecting the network

Use wp site option for site-scoped options and wp site meta for site metadata. Always pair the command with the intended URL when your shell context is not already unambiguous:

wp --path=/var/www/network --url=https://example.com/store site option get blogname
wp --path=/var/www/network --url=https://example.com/store site option update blogdescription "Store site"
wp --path=/var/www/network --url=https://example.com/store site meta list

Network-level metadata belongs under wp network meta; site-level values belong under wp site option or wp site meta. Mixing these scopes is a common cause of apparently “missing” settings because the value was written to a different table or context than the code reads.

Maintain plugins, themes, core and caches

The WP-CLI command index includes commands for core updates, plugin and theme management, language packs, cache operations, exports, users, roles, rewrites, search-and-replace and site health. In a network, decide whether an operation should run once for the network or in each site’s context, then test it on a staging copy or a low-risk site.

For a repeatable maintenance run:

1. Inventory URLs with wp site list --field=url and record the current core, plugin and theme versions.
2. Back up the database and uploads, and confirm that the backup can be restored.
3. Run the update or cache command against a selected site first by supplying --url.
4. Check the front end, login, media and scheduled jobs for that site.
5. Expand to the remaining sites only after the first result is healthy, logging each command and exit status.

Use wp help <command> locally for syntax, available flags and subcommands. Because the command reference is regenerated at every WP-CLI release, do not copy an option from an older script without checking the version installed on the server.

Migrate domains and paths safely with search-replace

Changing a network’s domain or path requires updating stored URLs in options, post content and other tables. WP-CLI’s search-and-replace command handles serialized data, but it still changes data and should be treated as a migration.

1. Make a verified database backup and pause writes if your change window requires consistency.
2. Run the exact old and new values in dry-run mode:

wp search-replace 'http://oldsite.com' 'http://newsite.com' --dry-run

3. Review the reported tables and replacement counts. Investigate unexpected matches rather than assuming every result is intended.
4. When the dry run is correct, run the same command without --dry-run:

wp search-replace 'http://oldsite.com' 'http://newsite.com'

5. Flush or rebuild relevant caches, verify redirects, logins, media URLs and each affected site’s canonical address, and retain the pre-migration backup until validation is complete.

For a multisite migration, repeat the review for every site URL and for network-level values. A replacement does not create DNS records or web-server rules; those must already match the destination addresses.

Best Value

Sale

HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs

• Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
• Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
• Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
• Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
• Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

$59.98

Buy on Amazon

Automate a controlled network deployment

A safe automation pattern separates discovery, selection and mutation. First run read-only commands and write their output to a log. Resolve each site’s ID and URL, apply one change with an explicit --url, check the result, and only then continue. Keep a failure list so one unavailable site does not get mistaken for a successful network-wide run.

For remote deployments, combine an alias or --ssh target with a fixed remote path. Verify the remote WordPress version, database connectivity and filesystem permissions before a migration. Never assume that a local WP-CLI binary is operating on the remote installation unless the command output proves it.

Managed WordPress hosting that supports multisite, SSH access and WP-CLI can reduce the work of maintaining the PHP runtime, database service and remote shell. Confirm those capabilities, backup/restore behavior and whether wildcard domains are supported before moving a network; feature names and availability vary by provider and region.

Troubleshooting by symptom

“Error: This does not seem to be a WordPress installation.”

The path is usually wrong or the remote path was omitted. Run the command with an absolute --path, check that wp-config.php is readable, and, for SSH, verify that the path is on the remote host rather than on your workstation.

The command operates on the wrong site

Add the full site URL with global --url. Then run site get, site option get blogname or another read-only query to confirm the context before repeating the mutation.

A new subdomain returns a DNS or certificate error

Site creation only writes WordPress records. Check DNS, the web server’s virtual-host matching and TLS coverage for the new hostname. On a subdirectory network, check rewrite rules and path collisions instead.

Permalinks or uploads fail after conversion

Recheck the multisite rewrite block, the installation base path and filesystem permissions. Apache installations specifically require the appropriate .htaccess rules after conversion. Test a newly created site and the original site separately.

A network command reports missing tables or options

Confirm that the command is connected to the intended database and site URL. A network-level value belongs to wp network meta, while a site’s value belongs to wp site option or wp site meta. Review the command’s help output for version-specific requirements.

A migration changed more rows than expected

Stop further writes, preserve the backup and compare the dry-run output with the actual replacement scope. Restore only after identifying the cause, then repeat with narrower old and new values and a new dry run.

Quick Recap

SaleBestseller No. 1

Gaoye Blue Light Blocking Glasses

$9.99

Bestseller No. 2

Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)

$6.59

SaleBestseller No. 3

LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men

$9.99

Bestseller No. 4

Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack

$9.99

SaleBestseller No. 5

HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs

$59.98

Compact operating checklist

• Back up the database, files and uploads before installation, conversion, deletion or replacement.
• Choose subdomain or subdirectory URLs and configure DNS, TLS and rewrites accordingly.
• Use --path to identify the WordPress files and --url to identify the site.
• Use --ssh or a protected alias only after testing a read-only remote command.
• Inventory with wp site list --field=url before changing sites.
• Use the wp site lifecycle commands for activation, archive, privacy, spam, mature status, emptying and deletion.
• Use wp network meta and wp super-admin for network-level administration.
• Run wp search-replace ... --dry-run before any URL replacement.
• Check wp help <command> on the server because flags and subcommands follow the installed WP-CLI release.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.