Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Backups & maintenance · Guide

How to Revert a WordPress Theme Update (Step by Step)

How to Revert a WordPress Theme Update (Step by Step)

Short answer

To revert a theme update, restore a backup from before the update or install the older version. For free themes, the WP Rollback plugin lets you pick an earlier version. For premium themes, upload the older ZIP under Appearance, Themes and choose to replace the active theme.

Key takeaways

  • WordPress has no built-in undo for theme updates.
  • WP Rollback handles free WordPress.org themes in a few clicks.
  • Uploading an older ZIP lets you replace the active theme.
  • Database settings usually survive, direct file edits do not.
  • Turn off auto-updates for the theme until it is fixed.

How do you revert a WordPress theme update?

Restore a backup taken before the update, or install the previous theme version with the WP Rollback plugin, by uploading the older ZIP file and choosing to replace the current theme, or with WP-CLI.

WordPress has no built-in undo button for theme updates. Once a new version replaces the theme files, the old ones are gone from your server.

You still have several reliable ways back. This guide explains each method, which one to pick, and how to stop the same update from coming back.

Which method should you use to revert a theme update?

Use a backup if the update changed more than the theme, WP Rollback for free WordPress.org themes, a ZIP upload for premium themes, and WP-CLI if you are comfortable with the command line.

MethodWorks forSkill levelNotes
Restore backupAny themeEasy with host toolsAlso reverts content since the backup
WP Rollback pluginWordPress.org themesEasyPicks versions from a list
Upload older ZIPAny theme with an old ZIPEasyNeeds the previous version file
WP-CLIWordPress.org themesAdvancedFast, no dashboard needed
SFTP folder swapAny themeModerateUseful when admin is broken

If the update broke the site so badly that you cannot log in, jump to the SFTP section below.

Should you take a backup before reverting?

Yes, back up the current site first, because rolling back can fail or clash with database changes the new version made, and you want a way back from the rollback too.

A full backup includes files and the database. Many hosts let you create one with a single click.

Some theme updates run database changes, such as new option formats. Older versions may not understand them, which is another reason to keep a fresh backup.

If you are unsure how to check a backup works, read our guide on how to test a WordPress backup.

Method 1: How do you revert by restoring a backup?

Restore the most recent backup taken before the theme update using your host's backup tool or your backup plugin, then check the site.

This is the cleanest method if the update happened very recently. It returns files and database to the exact earlier state.

The catch is that anything added since the backup, such as new posts, comments or orders, is lost. For busy sites and stores, a file-only restore of the theme folder is safer.

Our guide on how to restore a WordPress site from backup covers both full and partial restores.

Method 2: How do you roll back with the WP Rollback plugin?

Install WP Rollback, go to Appearance, then Themes, open the theme's details, click Rollback, choose an earlier version and confirm.

The free WP Rollback plugin pulls older versions from the WordPress.org theme directory. It replaces the theme files with the version you pick.

The steps are:

  1. Go to Plugins, then Add New, search for WP Rollback, install and activate it.
  2. Go to Appearance, then Themes.
  3. Click the theme to open its details.
  4. Click the Rollback button.
  5. Select the version you want and click Rollback.
  6. Confirm and wait for the success message.

This works for themes hosted on WordPress.org. Premium themes sold elsewhere are generally not supported, though check the plugin page for the latest details.

The plugin's source code is public in the WP Rollback GitHub repository, where you can also see reported issues.

You can deactivate and delete WP Rollback once you are done. It is only needed while you switch versions.

Method 3: How do you revert by uploading an older theme ZIP?

Get the previous version as a ZIP file, go to Appearance, Themes, Add New Theme, Upload Theme, choose the file and pick Replace active with uploaded when WordPress asks.

Since WordPress 5.5, uploading a theme that is already installed shows a comparison screen. You can then replace the current version with the uploaded one.

Where to find older ZIP files:

  • Premium themes: log in to the vendor's account area. Some vendors keep previous versions, others only offer the latest.
  • WordPress.org themes: older versions are kept in the directory's download system, though WP Rollback is easier.
  • Your own backups: many backup tools let you download just the theme folder.

Our guide on installing a WordPress theme from a ZIP file shows the upload screens in detail.

Method 4: How do you revert a theme update with WP-CLI?

Run wp theme install with the theme slug, the --version flag set to the older version number and the --force flag to overwrite the current files.

For example: wp theme install twentytwentyfour --version=1.0 --force. Replace the slug and version with your own.

The wp theme install documentation lists every option. The command only fetches versions from WordPress.org, unless you point it at a ZIP file path or URL.

WP-CLI is available on many hosts through SSH. See the WP-CLI project site for installation steps if your host does not include it.

Method 5: How do you revert when you cannot access the dashboard?

Connect with SFTP or your host's File Manager, rename the broken theme folder in wp-content/themes, then upload the older version's folder in its place.

Renaming the folder makes WordPress fall back to a default theme if one is installed. That often restores dashboard access straight away.

Upload the old version as a folder with the original name. Then reactivate it under Appearance, Themes if needed.

If you see a critical error message instead, WordPress may have sent a recovery mode email. Our guide on using WordPress recovery mode explains how to use it.

What happens to your theme customizations after reverting?

Settings saved in the database, such as Customizer options and Site Editor changes, usually survive a rollback, but edits made directly inside the theme files are lost.

Customizer settings are stored as theme mods in the database. Site Editor changes to templates and styles are stored as database records too.

Direct edits to the parent theme's files are overwritten by every update and every rollback. That is why custom code belongs in a child theme. Our explainer on what a child theme is shows why.

Check your menus, widgets and header after reverting. Version differences can occasionally reset a setting.

How do you stop the theme from updating again?

Turn off auto-updates for that theme in its details panel under Appearance, Themes, and hold off on manual updates until the developer fixes the problem.

WordPress shows an Enable auto-updates or Disable auto-updates link in the theme details. The Themes screen documentation describes this option.

Your host may also run its own automatic updates. Check your hosting dashboard for a separate setting.

Report the bug to the theme author through the support forum or the vendor's help desk. Include your WordPress and PHP versions and what broke.

What should you check after reverting?

Clear all caches, then check the home page, a post, a page, the header, the footer, menus and any WooCommerce pages on desktop and mobile.

Look at your browser console for JavaScript errors. They can show where a mismatch remains.

Run Site Health under Tools to spot new warnings. Our guide on using Site Health in WordPress explains the report.

Test any forms, search and checkout as a logged-out visitor. These features often depend on theme templates and scripts, so they are the first to break when versions mismatch.

If the site is still broken, the theme may not be the cause. Our guide on fixing a site after a theme update covers other things to check.

How do you avoid needing a rollback next time?

Test theme updates on a staging site first, take a backup before updating, and read the changelog for warnings about breaking changes.

Most managed hosts offer one-click staging. Update there, check key pages, then push to the live site.

Wait a few days after a major theme release before updating a live site. Early bugs are often fixed in a quick follow-up version.

Keep a short update routine for themes, plugins and core. The same habits help with plugins, as our guide on rolling back a plugin update explains.

Frequently asked questions

Can I undo a theme update without a backup?

Yes. For free themes, WP Rollback or WP-CLI can install an earlier version directly from WordPress.org. For premium themes, download an older version from the vendor if they offer it, then upload it and choose to replace the active theme.

Will reverting a theme update delete my content?

No. Posts, pages, media and most settings live in the database, not in the theme files. Only a full backup restore rolls back content too. Changes made directly inside the theme's own files are lost when the files are replaced.

Does WP Rollback work for premium themes?

WP Rollback mainly supports themes hosted in the WordPress.org directory, because it pulls versions from there. Most premium themes sold elsewhere are not covered, so use the vendor's older ZIP file or a backup instead.

How do I know which theme version I had before?

Check your backup files, the theme changelog, or your hosting activity logs. Some security and activity log plugins record update events with version numbers. If you have none of these, the version just before the current one is usually the safest choice.

Is it safe to stay on an old theme version?

Only for a short time. Old versions may miss security fixes. Revert to restore your site, report the problem to the developer, and update again once a fixed version is released, ideally testing it on staging first.

Sources

  1. WP Rollback WordPress.org Plugins
  2. wp theme install WordPress Developer Resources
  3. Appearance Themes Screen WordPress.org Documentation
  4. WP-CLI WP-CLI
  5. WP-Rollback GitHub

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.