> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dualentry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Change an Invoice's Bill-To Name and Address

> Change the name and address in an invoice PDF's Bill To block, per invoice or per contract, and bill a related entity while the contract stays on one customer.

Use this guide to control the name and address that print in the **Bill To** block of an invoice PDF. You can change them on a single invoice, or on a revenue contract so that every invoice generated from it carries them. The same approach lets you bill a related entity, such as a parent company or an affiliate, while the contract and its invoices stay on one customer.

## Prerequisites

You need permission to edit invoices, or to edit contracts for contract invoices. Have the name and full address of the party you're billing, including street, city, ZIP or postal code, and country.

## Change the bill-to name and address

You change the bill-to name and address on the invoice or on its revenue contract, depending on how the invoice was created. The **Bill To** block on an invoice PDF prints the invoice's **Billing Address**: its **Name**, or the customer's name when **Name** is empty, then the address lines. Each invoice copies its billing address when it's created, so editing the customer record's address later doesn't change existing invoices. Decide where to make the change from how the invoice was created:

* **Created by hand or from a sales order**: Edit the billing address on the invoice.
* **Generated from a revenue contract**: Edit the billing address on the contract. The customer section of a contract invoice is locked.

For everything else the **Bill To** block prints, and how to rename its label, see the [Custom Templates Reference](https://docs.dualentry.com/accountants/core-financials/accounts-receivable/custom-templates/custom-templates-reference.md#fields).

### On a single invoice

1. Navigate to **Money In > Invoices** and open the invoice, or create a new one and choose the customer.
2. In the customer section, choose the edit icon next to **Billing Address** to open **Edit Billing Address**.
3. In **Name**, enter the name to print. Leave it empty to print the customer's name.
4. Update **Address Line 1**, **Address Line 2**, **City**, **State** or **Region**, **Country**, and **ZIP** or **Postal Code** as needed, then choose **Save Address**.
5. Save the invoice and open its PDF preview to check the **Bill To** block.

The customer on the invoice doesn't change, so the balance stays on that customer's account in AR aging, statements, and payments.

### On a revenue contract

1. Navigate to **Revenue Recognition > Contracts** and open the contract.
2. In the customer section, choose the edit icon next to **Billing Address**.
3. Enter the **Name** and address to print, then choose **Save Address**.
4. Save the contract.

Invoices that DualEntry generates from the contract copy the contract's **Billing Address**, including **Name**. Open the next generated invoice's PDF to confirm the **Bill To** block.

You can change a contract's billing address only while the contract can be edited. Once any of its invoices has a posted payment, DualEntry shows `Contract already has paid invoices` and blocks the edit. Change orders, usage, and completed milestones block it too. Set the bill-to name and address before the first invoice is paid.

## Bill a related entity under one customer's contract

To bill a related entity, such as a parent company or an affiliate, while the contract and its invoices stay on one customer, put that entity in the contract's billing address. DualEntry has no separate bill-to customer. An invoice's customer must be the same as its contract's customer, and DualEntry rejects an invoice whose contract belongs to another customer with `Contract must belong to the same customer as the invoice.` To set it up:

1. Keep the contract, and its invoices, on the customer the contract belongs to.
2. Set the contract's **Billing Address** **Name** to the entity you're billing, and its address lines to that entity's address, as in [On a revenue contract](#on-a-revenue-contract).

The PDF then shows the other entity in **Bill To**, while revenue, receivables, and payments stay on the contract's customer. If the other entity should have its own AR balance, statements, and payments, create it as a separate customer with its own contract instead.

> [!NOTE]
>
> Tax calculation uses the invoice's shipping address first and falls back to the billing address. When the invoice has a shipping address, changing only the billing address doesn't change its tax. See [tax management](../tax-management/index).

## Result

The invoice PDF's **Bill To** block shows the name and address you set, and the invoice stays on the same customer for AR, statements, and payments.

## Troubleshooting

The following table lists common problems when changing the bill-to:

| What you see | Likely cause | What to do |
| - | - | - |
| The customer section is grayed out on an invoice | The invoice was generated from a contract | Change the billing address on the contract, then open the invoice's PDF to check the **Bill To** block. Once any of the contract's invoices is paid, DualEntry blocks editing the contract (`Contract already has paid invoices`), so the contract and its invoices keep their current billing address. |
| The PDF still shows the customer's name | **Name** on the billing address is empty | Enter a name in the billing address **Name** field. |
| An invoice still shows the old address after you edited the customer | Invoices keep their own copy of the address | Edit the billing address on the invoice or its contract. |
| `Billing Address is invalid. Please, edit it.` | The billing address is missing a required part. Entering only a **Name** starts an address. | Open **Edit Billing Address** and complete **Address Line 1**, **City**, and **Country**, plus **State** and **ZIP** or **Postal Code** when the country asks for them. |
| `Contract must belong to the same customer as the invoice.` | The invoice's customer differs from the contract's | Keep the contract's customer on the invoice and change the billing address instead. |

## Related resources

* [How to Invoice Customers and Run Dunning](https://docs.dualentry.com/accountants/core-financials/accounts-receivable/invoicing-and-dunning.md): create and send invoices
* [Custom Templates Reference](https://docs.dualentry.com/accountants/core-financials/accounts-receivable/custom-templates/custom-templates-reference.md): the fields and labels on the invoice PDF
* [Customer statements](https://docs.dualentry.com/accountants/core-financials/accounts-receivable/customer-statements.md): statements print the customer record's name and address


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.