How to perform a WordPress search and replace in the database

Updating your database records can be time-consuming if you do it manually. Luckily, there’s a way to update your WordPress database records in bulk. In this WordPress tutorial, we’ll cover the tutorial on how to perform a search and replace in WordPress database with a plugin and a MySQL query.

Download all-in-one WordPress cheat sheet

Reasons to use search and replace on a WordPress database

As your website depends heavily on its WordPress database, it’s essential to optimize your collection of data periodically.

Here are several reasons why you need to modify your WordPress database:

• Renaming keywords – WordPress SEO is ever-changing, and keywords that worked for your site a few months ago might not anymore. Performing search and replace can easily solve this problem for you.
• Misspelling and typos – this applies to data that contains typos and grammatical errors. They happen, and searching endlessly is never fun.
• Deleting characters – in some cases, WordPress updates can mess up your database by randomly adding weird characters or symbols to your data.

Regardless of the reason, the process of updating your database usually involves a large number of data tables. Imagine how tedious it would be to go through each table and modify the outdated data manually.

This is where the WordPress search and replace action comes in handy. It helps you find flawed data across database tables and modify them in no time.

How to perform search and replace on a WordPress database?

There are two ways to perform a search and replace on a WordPress database — using a plugin or a MySQL query. Just below, we’ll be covering both of the options.

Using a plugin

This method is ideal for users with no programming experience. With a plugin, you get to run a search and replace operation as many times as needed without dealing with a single line of code.

In this tutorial, we’re going to use Better Search Replace, one of the best WordPress plugins for this purpose.

Better Search Replace has plenty of useful features for managing your WordPress database. Its features besides search and replace include but are not limited to a backup creator, and database import features.

If you only need the search and replace function, the free version will do just fine. Should you need the rest of the features, you can upgrade to the Pro version at a starting price of $59 per year.

1. From your WordPress admin dashboard, navigate to the Plugins → Add New section.
2. Search for the Better Search Replace plugin, then select Install Now.

3. Click on the Activate button to activate the plugin.
4. From your WordPress admin dashboard, navigate to the Tools -> Better Search Replace section.

In the Search/Replace section, you will need to enter all of the following:

• Search for should have the word or phrase that you want to change.
• Replace with should hold the word or phrase that will replace the original.
• Select tables function lets you choose which tables of your database you want to modify.
• Replace GUIDs? lets you replace the modified data’s global unique identifier (GUID) number. If your site is already live, we advise against checking this box.
• Tick the Run as dry run? box if you want to review the changes first before executing them.

Once you’re done, click Run Search/Replace.

If you run the plugin without the dry run option, it will immediately make changes to your database.

Using MySQL query

It’s also possible to perform a search and replace in WordPress database using MySQL query via phpMyAdmin.

First, we’ll discuss how to identify your WordPress database name, which is worth reading if you have more than one database under your account. Then, we will uncover how to perform a search and replace in the database.

Here are the steps to locate your WordPress database name:

1. Navigate to the File Manager section from your hPanel dashboard.

2. Access the public_html folder and double-click the wp-config.php file to open it.

3. Locate the DB_NAME value. Your WordPress database name is the value that appears next to it. In this example, the name is “database-name-example.”

Our tutorial on finding WordPress database name offers more information and shows the steps using an FTP client.

After locating the database name, follow these steps to perform a search and replace in the database:

1. From your hPanel dashboard, navigate to the Databases → phpMyAdmin section.

2. Locate your WordPress database, then select Enter phpMyAdmin.

3. In the phpMyAdmin page, navigate to the SQL tab at the top menu bar.

4. Add the following code snippet to the available space

update TABLE_NAME set FIELD_NAME = replace(FIELD_NAME, 'Text to search, 'Text to replace it with');

Be sure to replace the placeholder texts with the correct information:

• TABLE_NAME represents the name of the table you want to modify.
• FIELD_NAME represents the name of the field/column where the targeted data resides.
• ‘Text to search’ contains the word or phrase that you wish to change.
• ‘Text to replace it with’ contains the word or phrase that will replace the previous text.

Once you are done writing the query, click on the Go button to execute it.

Conclusion

To keep your WordPress website functional and up to date, you need to maintain its database periodically. The maintenance includes replacing outdated data. It’s much easier to tackle the job in bulk with the help of WordPress search and update operation.

There are two methods to perform a search and update in the WordPress database:

1. Using the Better Search Replace plugin – suitable for users with no programming experience.
2. Using MySQL query – ideal for users with moderate to advanced technical knowledge.

Which method would you prefer? Let us know in the comment section down below!

WordPress search and replace FAQ

Here are the most common questions about WordPress search and replace.