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.
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 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
|v.7.3.0||View template files|
Edit files in an upgrade-safe way using overrides. Copy the template into a directory within your theme named
/woocommerce keeping the same file structure but removing the
Example: To override the admin order notification, copy:
The copied file will now override the WooCommerce default template file.
Warning: 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.
If you are a theme developer or using a theme with custom templates, you must declare WooCommerce theme support using the
add_theme_support function. See Declaring WooCommerce Support in Themes at GitHub.
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.