Introducing the Chargebee CLI

Why does my invoice PDF omit billing first and last name after customer details change?

Problem Statement

You changed a customer's billing name (or other billing details) or used Update Invoice Address on the invoice, downloaded the invoice PDF again, and the billing first and last name still do not appear (or do not change) as you expect.

Solution

First, check the billing first and last name stored on the affected invoice. If either value is missing or incorrect, use Update Invoice Address to correct the invoice. Updating customer details alone does not update an existing invoice. Continue with the template checks if the invoice has the correct names but the PDF still omits them.

The invoice PDF is generated from the invoice template your site uses. Whether first and last name appear depends on whether those fields are present on the document through merge tags (or the equivalent fields in an HTML template). A mismatch can also happen when you preview or edit one template, while the invoice actually uses another template — for example, a Multi Business Entity (MBE) site can use entity-level templates that take precedence over the site default, as described in Customizing Invoices.

Prerequisites

  • The invoice template builder must be enabled on your site. If it is not enabled, request access.
  • If you need entity-level invoice templates, Multi Business Entity must be enabled and you must contact Support to enable entity-level templates through the Early Access Program. You also need the Owner, Admin, Sales Manager, or Customer Support role (or another role your administrator grants) to configure entity-level settings.
  1. Confirm which business entity the invoice belongs to. If your site uses Multi Business Entity, open the same entity context before you change templates — entity-level invoice templates apply instead of the site-level template when they are configured.
  2. Go to Settings > Configure Chargebee > Invoices, Credit Notes and Quotes > General Settings > Invoice Templates, then click Manage. Use See current template (or your template list) to confirm which template is IN USE for that scope.
  3. Create an editable draft before adding billing-name fields. For a published custom template, click Duplicate as draft. If the current template is the Chargebee template, click Create New; that template cannot be customized or duplicated. In the draft, insert the billing-name merge tags using Merge Tags in the content format panel, as described under Add Merge Variables in Customizing Invoices.
  4. Use Preview and select the Customer and Invoice so the preview matches the real invoice, as described under Preview Invoice Templates.
  5. When the preview looks correct, click Publish, then click Use this template and Confirm so the template is IN USE, following Customizing Invoices.

Download or open the invoice PDF again. The billing first and last name appear when the template includes those merge tags and the values exist for that invoice.

Important Notes

  • Update Invoice Address on an invoice updates fields stored on that invoice record; what appears on the PDF still follows the template. If first and last name are omitted because the template has no merge tags for them, updating the invoice alone will not add them to the PDF. See Add Merge Variables under Customizing Invoices for how merge tags work in the template builder.