Using the WP-CLI to Perform a Search and Replace

WordPress Command Line Interface

WordPress hardcodes your site’s domain name into the database for such things as images, links, and page URLs. This can be a problem when you migrate the site to another domain name because clicking on links will redirect back to the old site. In this instance, you must update the URLs in your database in order for your site to function correctly.

The WP-CLI otherwise known as the WordPress Command Line Interface makes managing your WordPress website(s) simple if you are somewhat fluent in working through the command line interface.

For example, the WP-CLI command search-replace will search for a string of data that you specify and replace it with another. This is especially useful when you need to change a website URL / domain. In this guide, you will learn how to use the WP-CLI command search-replace to replace an old URL with a new URL.

Old URL to New URL

WP-CLI’s search-replace command replaces the URL configured for your website, should you decide to change the domain. For example, if you built a website on old-domain you can use this command to replace your database details to use new-domain.

1. Log into your cPanel account and look for Terminal under ADVANCED.


If this is your first time accessing Terminal you’ll receive a warning message and need to click the blue I understand and want to proceed button.


You will now see a black screen which is the interface for the Terminal. The part before the @ symbol is your cPanel username. The part after the @ symbol is the name of the server your hosting account is installed on.


2. Use the cd command to switch to the document root directory of your website. For example, if your site was installed in public_html you would type cd public_html. If the site is contained within a subdirectory inside public_html you would type cd public_html/my_website.

Be sure to replace public_html/my_website with the actual path to the document root directory of your website.

3. Run the following command (replacing old-domain and new-domain with the actual domains you wish to find and replace).

wp search-replace 'old-domain' 'new-domain' --dry-run

The resulting output displays the details, including tables and how many replacements are being made.

Once you have verified the replacements are correct, you can proceed to run the following command to have the database updated accordingly…

wp search-replace 'old-domain' 'new-domain'

If you’re wanting to run a search and replace a WordPress Multisite, use the following:

wp search-replace --network 'old-domain' 'new-domain'


**Note: You will need to check the upload_path table within the wp-options. If you're working with a domain that specifically mentions the domain name in the upload path, the search and replace will change the reference to the domain name and cause conflicts. If you find the domain name has changed edit the table to use the old file path. This will allow WordPress to continue to post the images at the same location. 

Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more
Reclaim Hosting Support Hours
8:00 am - 5:00 pm ET, Monday through Friday
Submit a Ticket
Get a quick and helpful response from the pros.
Need Extra Support?
No problem, we're here to help! Talk to us about Professional Services or custom Service Level Agreements.