How to Update a WordPress Theme Without Losing Customizations

Theme updates fix bugs, close security holes and keep your theme compatible with new WordPress versions. They also have one famous trap: if you edited your theme's files directly, updating the theme wipes those edits out. A custom header tweak, a few lines in functions.php, a changed template: gone with one click.

This guide shows how to tell whether your customizations are safe, how to update a WordPress theme step by step, how a child theme protects your changes, and how to roll back if an update breaks your layout.

Will updating my theme delete my customizations?#

It depends on where the customizations live:

Not sure? Compare your theme's files with a fresh copy from the theme's download page or WordPress.org. Any file that differs holds your changes.

Before you update: the checklist#

1. Take a full backup of files and database. See our WordPress backup guide.
2. Find any direct file edits and move them to a child theme or a code snippets plugin first (see below).
3. Read the changelog for the theme. Look for template changes, removed features or new PHP requirements.
4. Check your page builder and key plugins are compatible with the new version.
5. Test on staging for big theme updates. Our WordPress staging site guide shows how.

How to update a WordPress theme#

From the dashboard#

1. Go to Dashboard > Updates or Appearance > Themes.
2. Click Update now on the theme.
3. Clear your caches and check your site.

Premium themes#

Themes bought outside WordPress.org (from ThemeForest, Elegant Themes, StudioPress and others) only update in the dashboard when your license key is entered in the theme's settings or the vendor's updater plugin. Otherwise, download the new version from the vendor and upload it under Appearance > Themes > Add New > Upload Theme, choosing to replace the current version.

With WP-CLI#

• wp theme update your-theme-slug
• or wp theme update --all

Protect your changes with a child theme#

A child theme is a small theme that inherits everything from its parent and holds only your changes. The parent can then update freely.

1. Create a folder in wp-content/themes, for example yourtheme-child.
2. Add a style.css with a header naming the parent: a "Theme Name" line and a "Template" line with the parent folder's name.
3. Add a functions.php that loads the parent's stylesheet.
4. Copy over only the files you changed, and move your edits into them.
5. Activate the child theme under Appearance > Themes, then check your menus and widgets.

Many themes offer a ready-made child theme to download, and plugins such as Child Theme Configurator can create one for you. For small PHP tweaks, a code snippets plugin is often simpler than a child theme.

Block themes are different: changes made in the Site Editor are saved in the database and survive updates. If you want to keep them as files, the Create Block Theme plugin can export them into a child theme.

After the update: what to check#

1. Clear every cache: caching plugin, host and CDN.
2. Open your key pages in a private window on desktop and mobile: header, menu, footer, home page, blog posts, forms, cart and checkout.
3. Check the theme's settings and Customizer still hold your colors, fonts and logo.
4. Look at template pages such as search results, archives and 404, which are easy to forget.

How to roll back a theme update#

• Restore the previous version from your backup.
• Free themes from WordPress.org: download an older version from the theme's page (or the theme repository's version list) and upload it, replacing the current version.
• Premium themes: most vendors keep previous versions in your account downloads.
• With MyKavo installed, a copy of the theme is saved right before WordPress updates it, so you can put it back from the update history for seven days.

After rolling back, pause automatic updates for the theme until a fixed version is out. For broader update routines, see how to update WordPress safely.

Know within minutes if a theme update changed your layout#

Theme updates change how every page looks, so a problem shows up everywhere at once, and visitors notice before you do. The free MyKavo WordPress plugin is built to catch that:

• Every update recorded and checked. Theme, plugin and core updates, including automatic ones. On paid plans, from Starter, MyKavo checks your key pages right after the update and labels any change with the update behind it.
• Before-and-after screenshots. Drag a slider across the old and new version of a page to see exactly what moved.
• Snapshots and one-click rollback (free). A saved copy of the theme from right before the update, even for premium themes, ready to restore for seven days.
• "Did it crash?" (free). About ten seconds after an update, the site checks its own pages for server errors and the critical error page.

Summary#

Customizer settings, Site Editor changes, Additional CSS, child themes and page builder content survive theme updates; edits to the theme's own files do not. Back up, move direct edits to a child theme or a snippets plugin, read the changelog and test big updates on staging. Then update from the dashboard, the vendor's updater or WP-CLI, clear caches and check your pages. If something breaks, roll back from a backup, an older version or a saved snapshot.