WordPress Theme Broke After an Update
Page Builders & Themes
The update finished and took your customizations with it.
After a theme update the site looks wrong — lost styling, missing sections, a changed layout — or customizations you paid for have vanished entirely.
What it actually means
A theme update replaces the theme's files with new ones. Anything edited directly inside those files is overwritten, because the updater has no way to know which changes were yours and which were the theme author's.
This is what child themes exist to prevent. A child theme keeps your changes in a separate folder that updates never touch. Sites that break this way almost always had customizations written straight into the parent theme, often years ago by someone who has since moved on.
The second possibility is less dramatic: nothing was lost, and the theme simply changed. Major versions restructure templates and settings, and the result can look broken while being exactly as the author intended.
What usually causes it
Most likely first.
- 1
Customizations made in the parent theme
Edits to functions.php, templates, or style.css, overwritten by the update. The most common cause.
- 2
A major version with breaking changes
The theme restructured its templates or options, so old settings no longer map to anything.
- 3
A child theme referencing removed code
Your child theme overrides a template or calls a function the parent no longer provides.
- 4
Cached CSS from the previous version
The site is fine but the browser and CDN are serving stale stylesheets, so it looks broken.
- 5
A plugin depending on old theme hooks
An integration that relied on something the update removed.
How to fix it
Work through these in order. Take a backup before you change anything.
Step 1 — Clear every cache first
Caching plugin, CDN, and your own browser. A surprising share of post-update breakage is stale CSS and nothing more.
Step 2 — Check whether a child theme exists
If customizations lived in the parent theme, they are gone from the files — but often recoverable from a backup taken before the update.
Step 3 — Restore from backup on staging
Restore the pre-update site to a staging copy so you can extract the customizations rather than reconstructing them from memory.
Step 4 — Rebuild customizations in a child theme
Move them into a child theme as you restore them. This is the moment to fix the underlying problem, not just the symptom.
Step 5 — Read the changelog
If it was a major version, the author has usually documented what changed and what needs updating. That saves hours of guessing.
When to stop and call someone
Call someone if custom work has been lost and you have no recent backup, if the theme is heavily customized and the update is a major version, or if the theme is no longer maintained — at that point continuing to patch it costs more than moving to something supported.
Frequently asked
Because updating replaces the theme's files, and any code edited directly inside them is overwritten. Customizations survive updates only when they live in a child theme or a site-specific plugin, which keeps them in files the updater never touches.
A child theme is a small separate theme that inherits everything from the parent while holding your own changes. Any site with custom code or template changes needs one, because it is the only way to keep those changes through updates.
Usually, from a backup taken before the update. Restore that copy to a staging site and extract the customized files rather than overwriting the live site wholesale. Many hosts keep automatic daily backups that make this straightforward.
No. Outdated themes accumulate security vulnerabilities and eventually break on new PHP versions. The right response is to move customizations into a child theme and test updates on staging first, not to freeze the theme in place.
Back up the site, run the update on a staging copy first, check the changelog for breaking changes, and confirm your customizations are in a child theme. Then update production during quiet hours with the backup close to hand.
If you’d rather not
We do this work every week. These are the services that cover it.
- Best WordPress DesignA WordPress site that looks the part and does the work. Custom design, fast pages, and a layout built to turn visitors into customers.
- Replacing WordPressWhen WordPress becomes the thing you fight instead of the thing that works, it's time to move. We migrate you without losing rankings.
- Design & Layout FixesOverlapping text and broken spacing tell a customer you do not sweat details. We fix the glitches so the site looks as competent as the business.
See exactly what’s holding your website back.
Get a free audit of your site — speed, SEO, mobile, and security — with the fixes that matter most, delivered as a PDF to your inbox.