Override Delivery Notes templates

Override a template to change the layout of documents generated by Print Invoice & Delivery Notes for WooCommerce without editing the extension’s files.

Note:

This is a Developer level doc. If you are unfamiliar working with code and resolving potential conflicts, we recommend you work with a Woo Agency Partner for larger projects, or find a WooCommerce developer on Codeable for smaller customizations. We are unable to provide support for customizations under our Support Policy.

Before you start

↑ Back to top

You’ll need access to the active theme’s files and familiarity with PHP. Test changes on a staging site and keep a backup. A child theme keeps your changes separate from updates to its parent theme. The extension looks in the active theme’s directory; when a child theme is active, place the override in the child theme.

Copy a template into your theme

↑ Back to top
  1. In your active theme, create a directory named woocommerce-delivery-notes.
  2. Find the template to customize in wp-content/plugins/woocommerce-delivery-notes/templates/.
  3. Copy the file into the new directory, keeping its filename. For example, copy templates/invoice.php to wp-content/themes/your-active-theme/woocommerce-delivery-notes/invoice.php.
  4. Edit the copy in your theme. Leave the original extension file unchanged.

The extension checks the active theme for the named template before using its bundled copy. Each document template includes base.php, which contains the shared layout. Override base.php when a layout change must apply across document types; an override can affect invoices, receipts, delivery notes, packing slips, and credit notes.

Template files

↑ Back to top
  • invoice.php: invoice
  • receipt.php: receipt
  • deliverynote.php: delivery note
  • packingslip.php: packing slip
  • creditnote.php: credit note
  • base.php: shared document layout

Verify and maintain the override

↑ Back to top

Generate the affected document on your test site and check the change in both the browser view and PDF. If the change doesn’t appear, check the active theme, directory name, and filename. To return to the bundled template, remove or rename the theme copy and generate the document again.

After updating the extension, compare your override with the updated bundled template and incorporate any changes your customization needs. An override doesn’t automatically receive changes made to the bundled file.

For code-based customization, see the actions and filters reference.

Questions and support

↑ Back to top

Do you still have questions and need assistance? 

  • Get in touch with a Happiness Engineer via our Help Desk. We provide support for extensions developed by and/or sold on WooCommerce.com, and Jetpack/WordPress.com customers.
  • If you are not a customer, we recommend finding help in the WooCommerce support forum or hiring a Woo Agency Partner. These are trusted agencies with a proven track record of building highly customized, scalable online stores. Learn more about Woo Agency Partners.

Related Products

WooCommerce Shipping is a free label-printing and fulfillment extension built into WooCommerce that lets store owners buy and print USPS,...

Automatically calculate how much sales tax should be collected for WooCommerce orders — by city, country, or...

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.