--- post_title: Template structure & Overriding templates via a theme --- --- **Note:** this document is geared toward template development for classic themes. Check this other document for [block theme development](../../plugins/woocommerce-blocks/docs/designers/theming/README.md). We are unable to provide support for customizations under our [Support Policy](http://woocommerce.com/support-policy/). If you need to further customize a snippet, or extend its functionality, we highly recommend [Codeable](https://codeable.io/?ref=z4Hnp), or a [Certified WooExpert](https://woocommerce.com/experts/). --- ## Overview --- WooCommerce template files contain the **markup** and **template structure** for **frontend and HTML emails** of your store. [![Documentation for Template structure & Overriding templates via a theme](https://embed-ssl.wistia.com/deliveries/a2f57c5896505b39952aa8411a474066.jpg?image_play_button_size=2x&image_crop_resized=960x540&image_play_button=1&image_play_button_color=694397e0)](https://woocommerce.com/document/template-structure/?wvideo=8mvl4bro0g) 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 List --- Template files can be found within the **/woocommerce/templates/** directory: | Latest version | Files | |:---------------|:-----------------------------------------------------------------------------------------------------------| | v8.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.4.0/plugins/woocommerce/templates) | ---
Expand to view files of all major previous versions | Version | Files | |---------|------------------------------------------------------------------------------------------------------------| | v8.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.3.0/plugins/woocommerce/templates) | | v8.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.2.0/plugins/woocommerce/templates) | | v.8.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.1.0/plugins/woocommerce/templates) | | v8.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.0.0/plugins/woocommerce/templates) | | v7.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.9.0/plugins/woocommerce/templates) | | v7.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.8.0/plugins/woocommerce/templates) | | v7.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.7.0/plugins/woocommerce/templates) | | v7.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.6.0/plugins/woocommerce/templates) | | v7.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.5.0/plugins/woocommerce/templates) | | v7.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.4.0/plugins/woocommerce/templates) | | v7.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.3.0/plugins/woocommerce/templates) | | v7.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.2.0/plugins/woocommerce/templates) | | v7.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.1.0/plugins/woocommerce/templates) | | v7.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.0.0/plugins/woocommerce/templates) | | v6.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.9.0/plugins/woocommerce/templates) | | v6.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.8.0/plugins/woocommerce/templates) | | v6.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.7.0/plugins/woocommerce/templates) | | v6.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.6.0/plugins/woocommerce/templates) | | v6.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.5.0/plugins/woocommerce/templates) | | v6.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.4.0/plugins/woocommerce/templates) | | v6.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.3.0/plugins/woocommerce/templates) | | v6.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.2.0/plugins/woocommerce/templates) | | v6.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.1.0/plugins/woocommerce/templates) | | v6.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.0.0/plugins/woocommerce/templates) | | v5.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.9.0/templates) | | v5.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.8.0/templates) | | v5.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.7.0/templates) | | v5.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.6.0/templates) | | v5.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.5.0/templates) | | v5.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.4.0/templates) | | v5.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.3.0/templates) | | v5.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.2.0/templates) | | v5.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.1.0/templates) | | v5.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.0.0/templates) | | v4.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.9.0/templates) | | v4.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.8.0/templates) | | v4.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.7.0/templates) | | v4.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.6.0/templates) | | v4.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.5.0/templates) | | v4.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.4.0/templates) | | v4.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.3.0/templates) | | v4.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.2.0/templates) | | v4.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.1.0/templates) | | v4.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.0.0/templates) | | v3.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.9.0/templates) | | v3.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.8.0/templates) | | v3.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.9.0/templates) | | v3.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.6.0/templates) | | v3.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.5.0/templates) | | v3.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.4.0/templates) | | v3.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.3.0/templates) | | v3.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.2.0/templates) | | v3.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.1.0/templates) | | v3.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.0.0/templates) | | v2.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/2.6.0/templates) |
--- ## How to Edit 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 `/templates/` subdirectory. Example: To override the admin order notification, copy: `wp-content/plugins/woocommerce/templates/emails/admin-new-order.php` to `wp-content/themes/yourtheme/woocommerce/emails/admin-new-order.php`. 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](https://woocommerce.com/document/fix-outdated-templates-woocommerce/). ## For Custom 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](https://github.com/woocommerce/woocommerce/wiki/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. --- Need support with editing your Woo store? WooExpert agencies are here to help. They are trusted agencies with a proven track record of building highly customized, scalable online stores. [Hire an Expert](https://woocommerce.com/customizations/).