After a WooCommerce update, you might see a notice that your theme contains outdated copies of WooCommerce template files. It sounds technical — and it is — but it’s also common and manageable once you know what it means.
What the warning means
WooCommerce builds pages like the basket, checkout and product pages from template files. Themes can copy those templates into their own folder and change them — an override. When WooCommerce updates its own version of a template, your theme’s copy is left behind, marked with an older version number.
The warning tells you exactly that: your theme is using an older version of a template than the one WooCommerce now ships.
How to see which templates are affected
- Go to WooCommerce → Status.
- Scroll to the Templates section.
- Look for files marked as outdated — each shows your theme’s version next to the current core version.
Note whether the file lives in your theme or child theme. That tells you who needs to update it.
How serious is it?
It depends on the template and the change. Some updates are small; others add fields, security improvements or structure that extensions rely on. Warning signs that an outdated override is causing problems:
- checkout fields missing or appearing twice,
- payment methods not displaying correctly,
- broken layouts on the basket, account or order pages,
- extensions that don’t show their features where they should.
How to fix it
- Commercial theme: update the theme. Theme authors usually ship updated overrides; check the theme changelog.
- Child theme or custom overrides: compare your copy with the current file in
wp-content/plugins/woocommerce/templates/, reapply your changes onto the new version, and update the version number in the file header. - Overrides you no longer need: remove them, so WooCommerce uses its default template — after testing on staging.
Do this on a staging copy and test the pages affected, finishing with a full checkout test.
Keeping overrides under control
The fewer templates your theme overrides, the fewer can fall behind. Where possible, customise with hooks and CSS instead of copying whole templates, and document each override that remains. Checking WooCommerce → Status is part of our WooCommerce update process.
Frequently asked questions
Is the outdated templates warning serious?
Sometimes. Many outdated overrides keep working, but others can cause missing features, broken layouts or checkout problems. Treat it as a task to review, not an emergency — unless something visible is already wrong.
Where do I see which templates are outdated?
In WooCommerce → Status, in the Templates section. It lists files your theme overrides and flags those older than the version WooCommerce now ships.
Will updating my theme fix it?
If the templates come from a commercial theme, often yes — theme authors update their overrides. If they come from a child theme or custom work, someone needs to update them manually.
Can I just delete the outdated template files?
Removing an override makes WooCommerce use its default template, which may change how that part of your store looks. Test on staging before deleting anything.
