WooCommerce Docs

Documentation, Reference Materials, and Tutorials for your WooCommerce products

Search

Template Structure + Overriding Templates via a Theme

 

 

WooCommerce template files contain the markup and template structure for frontend and HTML emails of your store.

When you open these files, you will notice they all contain hooks that allow you to add/move content without needing to edit the template files themselves. This method protects against upgrade issues, as the template files can be left completely untouched.

Template files can be found within the /woocommerce/templates/ directory:

Version Files
v2.6.0 View template files
v2.5.0 View template files
v2.4.7 View template files
v2.3.8 View template files
v2.2.3 View template files
v2.1.0 View template files
v2.0.20 View template files
v1.6.6 View template files

You can edit these files in an upgrade-safe way using overrides. Copy it into a directory within your theme named /woocommerce, keeping the same file structure but removing the /templates/ subdirectory.

Example: To override the admin order notification, copy: woocommerce/templates/emails/admin-new-order.php to yourtheme/woocommerce/emails/admin-new-order.php

The copied file will now override the WooCommerce default template file.

Gotcha: If your theme has a woocommerce.php file, you will be unable to override the woocommerce/archive-product.php custom template in your theme, as woocommerce.php has priority over other template files. This is intended to prevent display issues.

Do not edit these files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost. For more detailed information, see Fixing Outdated WooCommerce Templates.

Note: We are unable to provide support for customizations under our Support Policy. If you are unfamiliar with code and templates and resolving potential conflicts, contact a WooExpert.
Back to the top