WordPress

Fixing Outdated WooCommerce Templates

WooCommerce sometimes updates the default templates when a new version of WooCommerce is released. This applies to major releases (WooCommerce 2.2, 2.6 and 3.0) but also to minor releases (WooCommerce 3.8.0).

As of version 3.3, most themes will look great with WooCommerce.

Loading...

If, however, you are using a theme with older templates or an older version of WooCommerce, you may need to update templates yourself or contact the theme author for an update.

  • Most theme authors fix themes in a timely manner, so you only need to update your theme to get the updated templates.
  • You need to update templates yourself if you modified templates or are using a child theme.

Otherwise, you need to select and use a different theme that already uses current WooCommerce templates.

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.

How to update outdated templates

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

Loading...
  1. Go toWooCommerce > Status> 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]
  3. 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.

Show More
Back to top button