You open the WordPress dashboard, see the little red badge, and click Update now. Nothing happens. Or it fails with an error. Or, more quietly, the theme just never shows an update at all, month after month, while everything else on the site moves on.
A theme that won't update is one of the most common WordPress support questions we get, and it hides four very different problems behind one symptom. Some are five-minute fixes. One of them means the theme has been abandoned and you need a plan. Here's how to tell which you've got.
First, which kind of "not updating" is it?
- The update fails. You click update, WordPress tries, and you get an error: a failed download, a permissions message, or "the package could not be installed."
- The update is offered but never applies. The badge keeps coming back, or the version number doesn't change after a "successful" update.
- No update is ever offered. The theme looks current in your dashboard because WordPress has nothing to compare it against.
- The update applies and breaks the site. Layout gone, white screen, or a fatal error the moment it finishes.
Each of these has a different cause, so don't skip this step.
Cause 1: the update mechanism is broken, not the theme
If the update fails with an error, the theme itself is usually fine. Common culprits:
- File permissions or ownership. WordPress can't write to the themes folder. Typical on sites that were moved between hosts by hand.
- Disk space or memory limits. The download succeeds, the unzip doesn't. Check the hosting control panel before anything else.
- Expired or missing licence. Premium themes check a licence key before they'll download an update. If the key lapsed, the update quietly fails or never appears.
- A stale connection to the vendor's server. The theme's updater plugin (Envato Market, ThemeForest, the vendor's own) is deactivated, outdated, or blocked by your firewall.
Fix the underlying issue, take a backup, and try again. If you're on a care plan this is exactly the kind of thing your host should be catching for you.
Cause 2: the theme was customised in place
If updates apply but your changes vanish, or the update "succeeds" but the site looks wrong, someone edited the theme's files directly instead of using a child theme. Every update overwrites those edits.
The fix is to move the customisations into a child theme so the parent can update safely. If you're not sure what a child theme is or whether one is worth building, we wrote a plain-English guide to child theme fixes versus a full rebuild.
Cause 3: the theme is abandoned
This is the one people don't want to hear. If no update has been offered in over a year, the vendor's site is dead or hasn't posted a changelog since 2022, support tickets go unanswered, and the theme's marketplace page is gone or marked "not supported", then the theme isn't failing to update. There's nothing to update to.
That's a different problem with different options, and it's the subject of our main guide, Fixing Abandoned or Broken WordPress Themes. The short version: the code is on your server, it can be adopted and maintained, and you don't have to rebuild the site just because the author left. If you want a quick way to confirm the diagnosis first, use our checklist for telling whether a WordPress theme has been abandoned.
Cause 4: the update works, and that's the problem
Sometimes the theme does update, straight into a version that isn't compatible with your PHP version, your page builder, or a plugin the site depends on. The site breaks the moment the update finishes.
The right move is to restore from the backup you took before updating (you did take one), then test the update on a staging copy before trying again. If the new version needs a newer PHP and the rest of your site can't take it yet, that's a maintenance job, not a theme job.
What to do this week
- Check the theme's last release date on the vendor's site or marketplace. Over a year old with no roadmap is a warning sign.
- Look for a licence prompt under Appearance or the theme's own settings panel. Renew or re-enter the key.
- Confirm the updater plugin is active if the theme came from a marketplace.
- Take a full backup before clicking update again. Every time.
- If the theme is abandoned, stop trying to update it and decide between patching, a child-theme fix, or a rebuild.
Not sure which one you have?
We offer a $99 theme rescue assessment: an engineer looks at the theme, tells you exactly what's wrong and whether it's worth saving, and gives you a fixed price to fix it. The $99 comes off that price if you go ahead.
Next step
Send us the theme. We'll tell you if it's worth saving.
A senior engineer diagnoses your abandoned or broken theme and writes back within one business day: what's wrong, patch or rebuild, and a fixed price. $99, credited toward the fix.