Skip to content
WordPress Guide

How to Replace a WordPress Plugin Without Breaking Things

The risk in a plugin swap is what the old plugin was quietly doing. How to list it, move it across in the right order, and remove the old plugin last.

A bright home office desk with a laptop and a monitor
7 sections · 7 min read
In this article · 7 sections

The decision is made: the old plugin has to go. Perhaps it has not been updated in years, perhaps its licence is lapsing and you have found a better option, or perhaps it simply does too much. The worry now is the swap itself, because this plugin holds your forms, your SEO settings or your backups, and you cannot afford a gap.

When you replace a WordPress plugin, the risk is rarely the new plugin. It is the things the old one was quietly doing that nobody wrote down. This post walks through finding those, moving them across in the right order, and only then removing the old plugin, the same careful order our complete WordPress guide recommends for any change to a live site. If you are still deciding which replacement to pick, our checklist on how to choose a WordPress plugin comes first. If the reason for the swap is that the plugin has been abandoned, read what to do about an abandoned plugin to judge how urgent it is.

List everything the old plugin does

Open the old plugin’s settings and go through every tab, writing down what is switched on. Then look outward:

  • Content: shortcodes or blocks it provides that appear in pages, posts, widgets or templates.
  • Data: entries, logs, redirects, images or records it stores.
  • Emails: notifications it sends, to whom and from which address.
  • Connections: outside services it talks to, such as an email list, a payment gateway, a CRM or Google tools.
  • Side jobs: features beyond its main purpose. An SEO plugin may also handle redirects, breadcrumbs and schema. A security plugin may also limit logins and send alerts.

That list is your test plan for later. Anything on it the new plugin cannot do needs another answer before you start.

The safe order for any swap

  1. Back up the files and the database, and keep a downloaded copy.
  2. Work on a copy if your host offers a staging site, then repeat the same steps on the live site once it works.
  3. Export the old plugin’s data where it allows: entries to CSV, redirects to a file, settings to an export file.
  4. Install the new plugin and set it up. For some kinds of plugin you must deactivate the old one first, as the sections below explain.
  5. Move or rebuild the content, data and settings.
  6. Swap the shortcodes or blocks in your pages for the new plugin’s versions.
  7. Test everything on your list.
  8. Deactivate the old plugin, test again, and delete it once you are confident.

How to replace a WordPress plugin, by type

SEO plugins

Never run two SEO plugins at the same time. Both will try to print titles, descriptions and other tags, and pages can end up with two sets of each. Install the new one and use its import tool, then deactivate the old one. Yoast SEO and Rank Math both offer to import data from other SEO plugins, and Rank Math’s setup wizard usually spots an existing SEO plugin and offers to bring its data across.

After the import, open several important pages and compare the SEO title, meta description and indexing setting with what you noted before. Check that pages you had hidden from search are still hidden. If the old plugin managed redirects, confirm they came across too. The sitemap address may change, so open the new plugin’s sitemap, then submit that address in Google Search Console and remove the old one there.

Form plugins

Forms usually have to be rebuilt in the new plugin, although some form plugins can import forms from others; check the new plugin’s tools or import screen. While rebuilding, copy across:

  • every field, including hidden ones and which fields are required
  • notification recipients, the from address and the reply-to setting
  • the confirmation message or thank-you page
  • spam protection, such as a CAPTCHA or honeypot setting
  • any connection to an email list or spreadsheet

Export old entries before you remove anything, because the new plugin will not see them. Then replace the form on each page and send a test submission through each form, checking the email arrives and the entry is saved.

Sliders and galleries

There is rarely an import path here. The images themselves are usually in the Media Library and stay put, but the slides, captions and links have to be rebuilt. This is a good moment to ask whether you need a plugin at all: the core Gallery block or a single Cover block often does the job with less weight.

Backup plugins

Backup files made by one plugin generally cannot be restored by another. So keep the old backups, downloaded and labelled, until the new plugin has built up its own history. Set up the new plugin, run a first full backup, check it finishes, and confirm the file is stored somewhere other than your server. If you can, test a restore on a staging copy. Only then remove the old plugin. Make sure the two are not both scheduled at the same time of night, which can strain a small hosting plan.

Redirect plugins

Export the redirect list from the old plugin, often as a CSV file, and import it into the new one. Spot-check a handful of old addresses afterwards with our redirect checker to confirm each still lands on the right page in one step.

Find every place the old plugin appears

Shortcodes are the usual cause of broken pages after a swap. Once the old plugin is gone, its shortcodes print as plain text, such as [old_slider id=”2″], in the middle of your page.

  • In Pages and Posts, search for the start of the shortcode. WordPress search looks inside content, so you get a list of every item that uses it.
  • Check Appearance → Widgets in classic themes, and the header and footer template parts under Appearance → Editor in block themes.
  • Look at your theme’s settings and any page builder templates.
  • Search your custom CSS for the old plugin’s class names; those rules can be removed afterwards.

Test as a visitor would

Log out, or use a private browser window, and go through your list on a phone and a computer. Submit each form. Click through sliders and galleries. Visit pages that used the old plugin. For SEO changes, view the page source and check there is only one title and one meta description. Then ask someone else to try the main tasks a customer would do: get in touch, buy, book.

Remove the old plugin last

Deactivate it and leave the site running for a few days while you watch form emails, backups and anything else it handled. When nothing has gone wrong, delete it from the Plugins screen. If it offered an option to delete its data on uninstall, decide first whether you still need that data; our post on how to remove leftover plugin data covers what it leaves and what is safe to clear.

A swap is one moment in a longer story, and the plugins section of the guide follows a plugin from first install to removal.

Frequently asked questions

Can I keep both plugins active while I switch?

For forms, sliders and galleries, yes, because each only acts where you place it. For SEO, caching, security and backup plugins, avoid it: two plugins doing the same site-wide job at once can print duplicate tags, fight over files or slow the server. Set up the new one, then deactivate the old one straight away.

Will switching SEO plugins hurt my rankings?

Nobody can promise what search engines will do, but if your titles, descriptions, indexing settings, canonical tags and redirects carry over intact, search engines see the same pages as before. Most trouble comes from settings that did not import. Compare key pages before and after, and watch Search Console for a few weeks.

What happens to entries stored by my old form plugin?

They stay in the database as long as the old plugin’s data is not deleted, but the new plugin cannot read them. Export them to a spreadsheet before you remove the old plugin. Then decide how long you need to keep them, especially if they contain customers’ personal details.

Is it safe to swap plugins on a live site without staging?

It can be done, but pick a quiet time, take a fresh backup and work through the steps in order. Prepare the new plugin fully before you switch anything off. Swaps involving checkout, bookings or backups are the ones where a staging copy really earns its keep.

Swaps that touch forms, SEO settings or backups are worth doing slowly, and it is fine to share the work. Planning or carrying out a plugin swap is something you can ask our WordPress support service about.

Next in this series: Code Snippets Plugin vs functions.php: Which to Use

Is Your Website Working Properly?

Get a free website health check from WebMaintor. We'll review your website's speed, security, forms, and technical health — and tell you exactly what needs attention.

No obligation. No automated reports. A real review by our team.