Fixing Outdated WooCommerce Templates

When a new version of WooCommerce is released, we sometimes update the default templates.

This applies to major releases (WooCommerce 2.2, 2.6 and 3.0) but also to minor releases (WooCommerce 2.3.9), and themes may break because they override WooCommerce’s default templates. Most theme authors fix their themes in a timely manner, so you only need to update your theme to get the updated templates.

If the themes are not updated, or if you modified templates or are using a child theme, you need to update the templates yourself.

Note: This is a Developer level doc. If you are unfamiliar with code/templates and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

How to update outdated templates

We need to determine what templates to update, make a backup of old templates and then restore any customizations.

  1. Go toWooCommerce > System Status. Scroll to the end of the page where there is a list of templates overridden by your theme/child theme and a warning message that they need to be updated. For example, the template cart-shipping.php is outdated:
    outdated-template
  1. Save a backup of the outdated template.
  2. Copy the default template from wp-content/plugins/woocommerce/templates/[path-to-the-template] and paste it in your theme folder found at: wp-content/themes/[path-to-theme]
  1. Open the template you pasted into the theme folder with a text editor of choice, such as Notepad++, and replicate any changes that you had to the previous template in your new, updated template file.

We recognize that it can be time consuming. This is why we try to avoid changing WooCommerce templates, but sometimes it is wise to break backwards compatibility.

FAQ ↑ Back to top

Where can I find the latest version of WooCommerce? ↑ Back to top

If you’re looking for the default templates to use for updating, you want to use the latest version of WooCommerce. There are a few easy ways to get the templates:

  1. Your current WooCommerce installation should be up to date, so the files are accessible on your site via FTP.
  2. Download the latest version from WordPress.org.
  3. Download all versions from the GitHub repository.

The feedback for this page is mostly negative. Shouldn’t you change the instructions? ↑ Back to top

Positive feedback is left by those who understand and use the instructions ‘as is’ with success.

Negative feedback is left by those who are non-devs and cannot understand the instructions, thinking that the steps are not detailed enough or that steps have been skipped.

The above note in the yellow box makes clear that this page is for developer-level users.

Why don’t you make a button to click and update everything? ↑ Back to top

It’s impossible to make a video or one-click update. Why? Because there are thousands of themes, and every theme is coded differently. One size does not fit all.

It’s the responsibility of theme authors to make their templates compatible with WooCommerce (many > one). It’s quite more complicated to make WooCommerce compatible with thousands of themes (one > many).

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top