Thanks for being patient while we implement your feedback to improve the developer experience.
Stencil Docs
Additional Customizations
Customizing Invoices

Customizing Invoices

There are four editable invoices in BigCommerce:

  1. Email invoice
  2. Merchant printable invoice
  3. Customer printable invoice
  4. Detailed merchant printable invoice (Supported by UK, France, and Poland)

Merchants commonly request developers modify the default content of invoices in order to satisfy specific business requirements and industry demands. In order to assist developers in making these changes, this articles contains instructions on how to edit each invoice.

Email invoice template

See the article Customizing Emails for editing merchant-facing email templates.

Merchant printable invoice

The merchant printable invoice is the invoice that can be printed from the control panel in Orders > View. Clicking the ... in the Action column will generate a list of options, one option being Print Invoice.

Print Order Invoice

The invoice that is generated by clicking Print Invoice relies on template files and variables from BigCommerce's legacy Blueprint themes framework. This invoice can be customized by performing the following steps:

  1. Download the invoice_printable.zip (opens in a new tab) file, which contains the skeleton of a printable invoice.
  2. Open the file in the text editor of your choice and edit the HTML file to match your desired customization.
  3. Use WebDAV to upload your customized HTML file to WebDAV's /template/ folder. We recommend CyberDuck, the freeware WebDAV (opens in a new tab) client, available for Windows and Mac OS. Your store's control panel offers a downloadable connection file pre-filled with most store credentials.

Note For a list of available variables, see Blueprint Email Templates.

Localizing the merchant printable invoice

Localization of the merchant-printed invoice is handled the same way as system and error storefront messages. PrintableInvoice.html relies on the Blueprint template that contains currently undecorated (untranslatable) strings. The following steps describe how to translate a merchant-printed invoice.

  1. Download the PrintableInvoice.html (opens in a new tab) file, which contains the skeleton of a printable invoice.
  2. Modify the content by replacing variables with their desired translated value.
VariableValue
%%LNG_ShippingAddress%%Shipping Address Translation
%%LNG_Quantity%%Quantity Translation
%%LNG_Code%%Code Translation
%%LNG_ProdName%%Product Name Translation
  1. Upload the edited templates via WebDAV (opens in a new tab). We recommend CyberDuck, the freeware WebDAV (opens in a new tab) client, available for Windows and Mac OS. Your store's control panel offers a downloadable connection file pre-filled with most store credentials.
  2. Review the merchant printable invoice via the control panel.

Customizing the customer printable invoice

The customer printable invoice is the printable invoice that is available on a storefront's order page for shoppers that have registered accounts with your store.

Customer Printable Invoice

This invoice becomes available in a shopper's orders after completing an order. A shopper can generate this invoice by clicking Print Invoice on the right-hand side of the page.

As a developer, you can customize this invoice by editing your theme's invoice.html file that is present in your theme's files. This file is located in templates/pages/account/orders/invoice.html.

Customizing the detailed merchant printable invoice

Use this invoice when a store receives an order from a shipping address in a country which supports PrintableDetailedInvoice. This invoice can be customized by performing the following steps:

  1. Download the PrintableDetailedInvoice.html (opens in a new tab) file, which contains the skeleton of the detailed printable invoice.
  2. Open the file in the text editor of your choice and edit the HTML file to match your desired customization.
  3. Use WebDAV to upload your customized HTML file to WebDAV's /template/ folder. We recommend CyberDuck, the freeware WebDAV (opens in a new tab) client, available for Windows and Mac OS. Your store's control panel offers a downloadable connection file pre-filled with most store credentials.

Resources

Related articles