Technote

Development workflow Practical

Series Making a theme feel like your brand Part 6 of 8

What to check before a theme update

Postponing an update is not a plan. Once you know what can break, updating stops being frightening and becomes a procedure with an order.

You often meet sites where updates are postponed out of fear. Postponing does not remove the problem, it accumulates it. The version gap widens, so each update changes more at once and becomes more frightening — while every published vulnerability in between stays open.

The real reason updates feel frightening is not knowing what will break. There is a way to know, and then updating becomes an ordinary procedure with a fixed order.

1. Keep a list of what you overrode

The only things that can break are the places you reached into the parent. There are three kinds: templates copied into the child theme, CSS aimed at parent selectors, and code attached to parent hooks.

That is why part four asked you to note the source version in every copied file. Those comments are your diff list at update time. Without them you have to re-read the entire theme on every release.

2. Read the changelog first

Update notices usually carry a list of changes. Three kinds of entry matter to a designer.

Reading a changelog — prepare for the top three, take it for the bottom two

A line about renamed classes is the dangerous one. The site keeps working while only your styles quietly miss their targets, and nobody notices until someone mentions days later that the spacing looks odd.

On a premium theme, also check that the licence is still active. These usually run yearly, and once it lapses the update notices stop arriving — which is easy to misread as “there are no updates”.

3. Work in order

The update order — make the state reversible before anything else

Back up files and database together. It feels like rolling back the theme alone would be enough, but updates sometimes convert stored theme settings to a new structure, so you need the pair.

Staging means a copy configured like production. Update there first and look at it. If a copy is out of reach, at minimum do it at your quietest hour with the rollback ready.

Comparing screens is done by eye. Before updating, screenshot the pages that matter — home, a service page, one article, the contact form, and a mobile view — then place the post-update versions beside them. Those five catch most regressions.

After the update

Two more things beyond the visuals. Check that the parent stylesheet handle you depended on still exists — if it was renamed, your styles still load but lose their place in the order — and diff your copied templates against the new parent files. The second can wait, but a deferred diff doubles at the next release.

The wider procedure for keeping updates safe lives in the development workflow archive, and the actual working flow, staging and regression checks included, is published step by step on our process page.

Next part

Part seven is about page builders: what you give up in exchange for easier editing, and where to draw the line so you can keep both.

More on this topic

All technotes

Development workflow Practical

Turning taste arguments into rule checks

"It feels a bit cramped" can be neither argued with nor fixed. Spacing off the scale, colour off the palette, contrast below threshold, missing states — four rules…

Designers 9 min read

Development workflow Practical

Do not swap everything at once

A full swap makes every problem appear at the same moment — which means none of them can be attributed. So you switch one template at a time.

Designers 6 min read

Development workflow Practical

Adding an SCSS build, and whether to commit the output

WordPress themes are expected to deploy without a build step, which leads to the opposite conclusion from ordinary application code — and to its own costs.

Developers 7 min read

₩270,000 · Join the program