> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# 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

To define merchant-facing email invoice templates, see the [Email Templates Overview](/developer/docs/admin/store-configuration/emails) and the reference for the [email invoice object](/developer/docs/admin/store-configuration/emails#invoice).

## 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](/_fern-img/a80fc2ff98e22a896f8b86f02f66536b91782e5b7ddd72bb6f5d599d1940e022.webp)

The invoice that is generated by clicking **Print Invoice** relies on template files and variables from [BigCommerce's legacy Blueprint themes framework](/developer/docs/storefront/stencil/themes/templates). This invoice can be customized by performing the following steps:

1. Download the

   invoice\_printable.zip

   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](https://support.bigcommerce.com/s/article/File-Access-WebDAV#webdav-client) client, available for Windows and macOS. Your store's control panel offers a downloadable connection file pre-filled with most store credentials.

> **Note**
>
> **Note**
> For a list of available variables, see [Blueprint Email Templates](/developer/docs/storefront/stencil/themes/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

   file, which contains the skeleton of a printable invoice.
2. Modify the content by replacing variables with their desired translated value.

| Variable                 | Value                        |
| :----------------------- | :--------------------------- |
| %%LNG\_ShippingAddress%% | Shipping Address Translation |
| `%%LNG_Quantity%%`       | Quantity Translation         |
| `%%LNG_Code%%`           | Code Translation             |
| `%%LNG_ProdName%%`       | Product Name Translation     |

3. Upload the edited templates via [WebDAV](https://support.bigcommerce.com/s/article/File-Access-WebDAV#webdav-client). We recommend Cyberduck, the freeware [WebDAV](https://support.bigcommerce.com/s/article/File-Access-WebDAV#webdav-client) client, available for Windows and macOS. Your store's control panel offers a downloadable connection file pre-filled with most store credentials.
4. Review the merchant printable invoice via the control panel.

## 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

   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](https://support.bigcommerce.com/s/article/File-Access-WebDAV#webdav-client) client, available for Windows and macOS. Your store's control panel offers a downloadable connection file pre-filled with most store credentials.

## 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](/_fern-img/bf59819ad2cdf2e56e27aa44350eb571d01468b3ac1e45cea8194f539a0e4a95.webp)

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`.

## Resources

### Related articles

* [Email Templates Overview](/developer/docs/admin/store-configuration/emails)
* [Email Templates Object Reference](/developer/docs/admin/store-configuration/emails)
* [Shrinking a Theme by Excluding Static Assets Using WebDAV](/developer/docs/storefront/stencil/deployment/theme-size#shrinking-a-theme)
* [Blueprint Theme Email Templates](/developer/docs/storefront/stencil/themes/templates)
* [Uploading and Linking to a File in Your Store (Help Center)](https://support.bigcommerce.com/s/article/How-do-I-add-and-link-to-a-file-in-my-store#upload-a-file)
* [Editing and Printing Invoices (Help Center)](https://support.bigcommerce.com/s/article/Invoices#custom)
* [WebDAV File Access (Help Center)](https://support.bigcommerce.com/s/article/File-Access-WebDAV)