• Categories
    • Tutorials
    • Beginners Guide
    • WordPress News
    • WordPress Security
    • Best WordPress Plugins
    • WordPress Themes
    • Product Reviews
    • WP Tips & Tricks
  • Guides
    • Start a Blog
    • Make a Website
    • WordPress Hosting
  • WordPress Hosting
    • A2 Hosting
    • HostGator
    • Bluehost
    • Cloudways
  • Managed Hosting
    • WPEngine
    • Rocket.net
    • WPX
    • Kinsta
  • Coupons
    • WPEngine
    • Flywheel
    • Cloudways
    • A2 Hosting
    • WPX Hosting
WordPress Tips & Tricks

How to Downgrade WordPress Versions, Plugins, and Themes (and Why You Might Want to)

Last Updated on: June 27, 2017 Rachel Adnyana 6 Comments

How to Downgrade WordPress Versions, Plugins, and Themes (and Why You Might Want to)

The WordPress core code is updated pretty regularly and in most cases you’re going to want to make sure you upgrade to the latest stable version as soon as possible. Using the latest version of WordPress ensures that you have access to all the latest features and any security holes that have been discovered since the last update have been patched.

However, despite extensive testing, it’s impossible to discover every bug and sometimes some do get through. More often, plugins don’t play nicely with the newer version of WordPress and it can take some time for plugin developers to catch up and release a new version.

For these reasons, you may wish to revert to an earlier version of WordPress until these issues are sorted out. The same is true if you install a new version of a plugin or theme and have a problem with it.

Usually rolling back versions should only be done temporarily until bugs are fixed and you can go ahead and update to the latest version again.

Before You Downgrade

Before you go ahead and downgrade the WordPress core code, you should be sure that’s definitely the best course of action. It’s normally plugins that cause bugs, rather than WordPress itself and if so, the problem can usually be resolved by deactivating the plugin causing the problem until an updated more compatible version is released.

If you’re sure it’s the WordPress core code that’s causing problems, or the plugin is vital to your site, or it’s a theme compatibility issue, then downgrading temporarily is probably your best option until the bugs are ironed out

Before you downgrade, it’s important to do a full backup of your site and database in case anything goes wrong. There are several plugins that can handle this for you.

Downgrade WordPress with WP Downgrade Plugin

The WP Downgrade plugin can handle the downgrade for you by forcing the installation of a specified WordPress release.

The plugin runs just like the normal WordPress installer so it’s very easy to use. You simply choose the version of WordPress you want to install and it’s downloaded directly from wordpress.org and installed as normal. As always, remember to do a full backup before using this plugin!

Check which version of WordPress you’re currently using. You can see this information in your dashboard:

WordPress version screenshot

In most cases you should downgrade to the last update before the one you installed. You can see all the version release numbers at the WordPress Release Archive.

Find the version you want to downgrade to and type it into the settings on the WP Downgrade plugin:

WP downgrade plugin screenshot

You can then click the “Save Changes” button to run the installation of the previous version of WordPress.

Downgrading WordPress Manually

If you’d rather handle the process manually, or your site is so messed up that you can’t even get into your admin panel, you can follow these instructions to downgrade without the help of a plugin.

1. Download WordPress

you’ll need to grab a copy of the WordPress version you were using before things went wrong. You can download every version of WordPress from the official release archive. Normally you’ll only want to go one step back and download the version just before the one you installed last. If you install an older version of WordPress, you could be opening up your site to security flaws.

2. Deactivate Plugins

You should then deactivate all your plugins from the Plugins page on your dashboard and logout of WordPress:

deactivate plugins screenshot

If you can’t log in to your site, don’t worry – you can complete the next steps without deactivating the plugins and all will probably be fine. If a plugin is causing issues, you can deactivate it by temporarily changing the plugin folder name via FTP:

Plugin folder ftp screenshot

3. Delete Core WordPress Files and Upload Fresh Copy of WordPress

Use an FTP client to access your WordPress site on the server and delete the wp-admin and wp-includes folders only. You can then upload the contents of the WordPress version you downloaded (except the wp-content folder), which will copy over all the existing files

Make sure you do not upload the contents of the wp-content folder as this could affect your site content.

Copying WordPress files via FTP

4. Finishing the Re-installation

WordPress is then essentially reinstalled as an older version and you can login as normal. You’ll see a message saying you need to update your database (just as you would with a normal upgrade) and assuming this completes normally, you’re ready to go.

You may also need to rebuild your permalinks if you’re getting 404 errors on your posts after reinstalling WordPress – you can find this option in Settings > Permalinks. Just select a different permalinks option in your settings, save the change, and then revert back to your original option and save again. This should sort out the problem.

5. Disable Automatic Updates

The final step is to disable automatic WordPress updates to stop WordPress from upgrading itself again. You’ll want to disable all automatic updates until you’re sure everything is compatible and working properly again. You can then upgrade manually and turn auto updates on again when you’re ready.

You can also disable auto updates by editing your wp-config.php file to include the following line of code:

define( 'AUTOMATIC_UPDATER_DISABLED', true );

You can also use the Advanced Automatic Updates plugin to have easier control over automatic updates of the core code, plugins, and themes on your WordPress site.

Downgrading WordPress Plugins and Themes with WP Rollback

Generally, WordPress plugins are not as thoroughly tested as the core code, so it is much more likely that you may have a problem when upgrading to a new version of a plugin. This is often due to conflicts with other plugins or incompatibilities with the theme you’re using. Many themes now have plugins embedded into their code so if you install the same plugin separately, it can also cause problems.

If you need to rollback to a previous version of a plugin or theme due to a software bug, make sure you let the developer know about the bug so it can be fixed for the next release.

The easiest way to downgrade plugins and themes is by using the WP rollback plugin.

Using this plugin is very simple. You simply install it and use the interface to search for the plugin you want to rollback. You can then choose the version you want to install and re-install the plugin in one click.

Of course as with any major site updates, make sure you backup everything first and it’s best to test out on a local version of your site or staging environment before you do anything on the live site.

As with the WordPress core code, you’ll normally only want to roll back to the previous release as it can introduce security problems to install old plugin versions.

This plugins also only works with plugins and themes that are in the WordPress repository. If you’re using a premium plugin or theme, or one downloaded from another repository such as Github, you’ll need to download the older version of the code and install it manually.

Before you rollback a plugin or theme, you should deactivate automatic updates in WordPress. This will stop the plugin or theme from updating itself again until you’re sure the problems you were having with the latest version are fixed. You can do this with the Advanced Automatic Updates plugin mentioned earlier, or you can add the following lines of code to your theme’s function.php file:

add_filter( 'auto_update_plugin', '__return_false' );

add_filter( 'auto_update_theme', '__return_false' );

How to Rollback a WordPress Plugin

After you’ve installed the WP Rollback plugin, go to Plugins in your WordPress admin panel and you should see a new link next to “Deactivate” and “Edit” – “Rollback”. If there’s no rollback link, it means the plugin couldn’t be found in the WordPress repository and you’ll need to do a manual install of an earlier version of the code.

WP Rollback screenshot

Click the Rollback link and you’ll be taken to a screen where you can choose the version of the plugin you want to rollback to. You’ll also see a note letting you know which version you have installed currently:

WP Rollback plugin screenshot

Once you select the version and click the Rollback button, you’ll get a confirmation screen reminding you to backup. If you’ve not backed up yet, go and do it now!

WP rollback plugin screenshot

You will then see a message that looks like the standard update screen, which should confirm that your plugin has been “updated” to the version you selected:

WP rollback plugin screenshot

How to Rollback Themes

The procedure for installing a previous version of your theme is very similar to rolling back plugins. Go to Appearance > Themes in your dashboard and click “Theme Details” of the theme you want to rollback. You’ll see a pop-up with buttons for “Activate”, “Live Preview” and “Delete”. If the theme is available in the WordPress repository, you should have an additional button, “Rollback”.

Rollback theme plugin

Click the rollback button and you’ll be taken to a screen that allows you to see what version you have installed currently and choose a different version to install:

WP Rollback plugin screenshot

Just as before, you’ll get a confirmation theme checking if you really want to rollback, and then the standard WordPress theme update message.

How to Downgrade Plugins and Themes Manually

If you downloaded your theme or plugins from somewhere other than the WordPress repository, you’ll need to perform a manual rollback.

1. Backup Your Site

Start by making a full backup of your whole WordPress site including all the content and the database.

2. Download Previous Version of Plugin or Theme

You’ll then need to download the older version of code for the plugin or theme you want to downgrade. You can usually get this from the developer website or from the repository you originally downloaded it from. Look for a link to “all versions” or “older versions”.

3. Rename Your Plugin or Theme Folder

Once you’ve downloaded the .zip file, log into your site with FTP and navigate to your wp-content folder. Go into either the themes or plugins folder, depending on what you’re wanting to rollback.

Change the name of the folder for the theme or plugin that you want to downgrade. I normally add “-temp” to the filename. This makes it easy to restore the original version again if something goes wrong.

4. Install the Previous Plugin or Theme Version

Now go back into your WordPress admin panel.

If you’re installing a Plugin, go to Plugins > Add New and click the “Upload Plugin” button.

If you’re installing a theme, go to Appearance > Themes, click the “Add New” button, and then the “Upload Theme” button.

You can then find the plugin or theme .zip in the location you downloaded it to and let WordPress run the install as normal.

Activate the plugin or theme and check that everything is working properly. If you’re confident that everything is ok, you can then go back into your ftp client and delete the folder for the theme or plugin that you renamed earlier.

This procedure should work in most cases if the plugin hasn’t made significant changes to your database. If you do get errors then you may need to restore your entire WordPress database. This is why it is so important to create a new backup before you carry out any updates.

Hopefully any problems should be sorted once you’ve restored your site from backup but if you come across this situation it’s best to contact the developer of the plugin for advice on how to proceed.

Summing Up

In general, using outdated versions of WordPress as well as plugins and themes should be avoided, but in some cases this is the only way to get your site up and running again if you run into problems after updating to the latest version.

If you do decide to downgrade, you can follow the steps I’ve explained here, which are pretty straightforward, but do make sure to backup beforehand. Many catastrophic WordPress problems can be avoided as long as you have a working backup to restore from.

If you use a lot of plugins on your site and frequently have issues with upgrades and errors, you might consider moving to managed WordPress hosting. These services will handle all the updates for you and easily restore your site if anything goes wrong so that downtime is minimized.

+ Share
Disclosure

Rachel Adnyana

Rachel is a web-developer-turned-writer who has successfully convinced many clients to switch to WordPress over the years. She blogs about her life as an expat in Bali at How to Escape.

Related Posts

Back to all articles
  • WordPress’ Settings: A New User’s Checklist

    WordPress’ Settings: A New User’s Checklist

  • Introducing The Wp-Config.Php File For WordPress

    The wp-config.php File: Why It’s the Most Important File For WordPress

  • Best Black Friday Deals

    Black Friday and Cyber Monday Deals, Coupons, & Discounts for 2021

Coupons

View more deals
  • LearnDash Coupon Code!
    40% off

    LearnDash Coupon

    Searching for a LearnDash coupon to save on one of the top W
    Get This Deal
  • WP Activity Log Coupon
    20% OFF

    WP Activity Log Coupon

    Website security encompasses a whole host of elements, tasks, and
    Get This Deal
  • Recipe Card Blocks Coupon
    15% OFF

    Recipe Card Blocks Coupon

    Running a cooking or food website can be fun (and tasty) – but
    Get This Deal
6 Comments Leave a Reply
  1. Emmerey Rose says

    July 14, 2017 at 5:21 am

    A plugin to automate this would be awesome. Thanks for recommending WP rollback plugin. I haven’t heard or tried it. Is it a free plugin?

    Reply
  2. Luke Cavanagh says

    August 30, 2017 at 2:40 pm

    WP Rollback works very well, for plugin rollback. It does not make sense to downgrade WP core.

    Reply
  3. Allan says

    January 9, 2019 at 4:12 am

    Great explanation and help! Thanks! Saves me the grief of dealing with an upgrade when I’m not ready.

    Reply
  4. Onam Sharma says

    January 12, 2019 at 10:19 am

    Thanks it really helped me

    Reply
  5. Marcel says

    August 15, 2020 at 11:53 pm

    Awesome plugin! Went back one version and solved all my WP problems! Videos and a “masonry gallery” on my homepage didn’t stretch out, now they do again! Wanted to donate but the donate button doesn’t seem to work anymore.

    Reply
  6. Holly says

    October 28, 2020 at 2:32 pm

    i am not seeing the rollback feature for my selected theme. i need to undo the them update for Spangle Lite

    Reply

Leave a Reply Cancel reply

Full Disclosure This post may contain affiliate links, meaning that if you click on one of the links and purchase an item, we may receive a commission (at no additional cost to you). All opinions are our own and we do not accept payments for positive reviews.

Our Newsletter

Get awesome content delivered straight to your inbox.

Thank you!

You have successfully joined our subscriber list.

.

THE BEST OF WPKUBE

Some of the best content we have published so far.

BEGINNER GUIDES & REVIEWS

18 Best Cheap WordPress Hosting Providers in 2023 (From $1.99)
210 Best WordPress Hosting Options for 2023 (Pros & Cons)
38 Best Managed WordPress Hosting Providers for 2023 Compared
45 Best WooCommerce Hosting Providers Compared in 2023 (All Budgets)
5Top 9 Landing Page Plugins for WordPress (2023)
69 Best List Building Plugins for WordPress In 2023
7How to Fix the 500 Internal Server Error on Your WordPress Website
8Thrive Themes Review: A Look At The Full Membership
9Beaver Builder Review: Is it The Best Page Builder Plugin for WordPress (2023)?
10OptimizePress Review: Create Landing Pages with Ease
11How to Make a Website: Complete Beginner’s Guide
12Top 22 Best Free Stock Photo Resources For Your Site
1317 of the Best Google Fonts for 2023 (And How to Use Them in WordPress)
14How to Start a Blog in 2022 (Step by Step Guide)
15How To Fix ‘503 Service Unavailable’ WordPress Error
1611 Best Contact Form Plugins for WordPress in 2023
17How to Add a Custom Logo to Your WordPress Site
18How to Fix Error Establishing a Database Connection in WordPress

Cloudways: 30% OFF Deal

Save 30% on one of the best cloud hosting providers.

Get this Deal

Flywheel(our review)

Featured In Forbes Huffpost Entrepreneur SEJ

About WPKube

WPKube is an online WordPress resource which focuses on WordPress tutorials, How-to’s, guides, plugins, news, and more. We aim to provide the most comprehensive beginner’s guides to anything about WordPress — from installing plugins, themes, automated installs and setups, to creating and setting up pages for your website.

We have over 500+ tutorials, guides, product reviews, tips, and tricks about WordPress. Founded by Devesh Sharma, the main goal of this site is to provide useful information on anything and everything WordPress.

Twitter Facebook

Useful Links

  • Behind the Scenes
  • Beginner Guides
  • WordPress Hosting
  • WooCommerce Themes
  • MeridianThemes
  • Exclusive WordPress Deals
View All Guides »

Reviews

  • WPEngine 33% OFF
  • Thrive Leads
  • Flywheel 33% OFF
  • Divi Theme 20% OFF
  • Thrive Architect
  • Elegant Themes
Reviews »

Deals

  • InMotion Hosting
  • LifterLMS Coupon
  • LiquidWeb Coupon
  • WPEngine Coupon
  • A2 Hosting
  • FloThemes
More Deals »
© Copyright 2023 WPKube ® All Rights Reserved.
  • Contact
  • Site Terms
  • Disclosure
  • Privacy Policy