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

# Invoice configuration

> Configure Hyperline invoices from settings: brand assets, trade and legal names, tax IDs, footers, numbering format, and default behaviors.

If you did not already configure your invoices during the initial onboarding process, you can do it anytime from Hyperline's interface, from the **Settings** pages.

## Business

In the **Business** section, you can customize your brand's logo and color that will appear on your invoices.

You also need to fill in the trade and legal names of your company, your tax ID (if applicable), and the postal address that will appear on the invoices. These details are required to make your invoices legally compliant.

<Info>
  Hyperline shows a real-time preview on the right of the screen so you can see
  how your changes affect your invoice design.
</Info>

<Frame>
  <img src="https://mintcdn.com/hyperline/EDrbzAFie11ohucW/images/invoices/conf1.png?fit=max&auto=format&n=EDrbzAFie11ohucW&q=85&s=4ecd2da86b13d4fba5475940244c21f2" width="1318" height="934" data-path="images/invoices/conf1.png" />
</Frame>

Click **Save changes** once you are done.

## Invoicing

You can customize settings that will apply to all generated invoices. Hyperline applies new configurations to invoices generated after you save the changes.

<Frame>
  <img src="https://mintcdn.com/hyperline/EDrbzAFie11ohucW/images/invoices/conf2.png?fit=max&auto=format&n=EDrbzAFie11ohucW&q=85&s=8b8e9908f729b0f16fa0fc752ee5b9cd" width="1316" height="934" data-path="images/invoices/conf2.png" />
</Frame>

#### Invoicing number

You can customize how Hyperline numbers your invoices. You can do this in **Settings**, in the **Invoicing** section.

<Info>
  Each invoice must have a **unique number**. These numbers should follow a
  sequential order. This is a legal requirement that applies internationally.
  However, Hyperline lets you select the invoice number pattern you want to use.
</Info>

The `{number}` variable is mandatory. You can then add any text, the year variable `{YYYY}`, the month variable `{MM}` and/or the day variable `{DD}` to customize the invoice number format.

| Variable | Invoice number format |
| - | - |
| number | 1 |
| number-YYYY | 1-2023 |
| number-YYYY-MM | 1-2023-10 |
| number-YYYY-MM-DD | 1-2023-10-10 |
| YYYY-MM-DD-00number | 2023-10-10-001 |

#### Invoice legal information

As legal requirements vary from country to country, and are sometimes industry-specific, Hyperline provides a space for you to add any relevant legal information to your invoices.

Check in with your legal and accounting teams if needed to make sure you include all necessary information here. It can go from tax specificities to penalties applied if the invoice is not paid on time, to anything else.

#### Additional information

You can insert here any additional information you'd like to provide. It could be details about your invoicing policy (late payment fees, conditions, etc.) or mentions about taxes if relevant.

By clicking the globe icon on the right side of the text area, you can translate both the legal and additional information into multiple languages. Hyperline automatically selects the relevant language when it generates the invoice.

<Frame>
  <img src="https://mintcdn.com/hyperline/EDrbzAFie11ohucW/images/invoices/conf7.png?fit=max&auto=format&n=EDrbzAFie11ohucW&q=85&s=7a5cf86cac3ddf66381abd96fa01abae" width="2484" height="1420" data-path="images/invoices/conf7.png" />
</Frame>

#### Template variables

Invoice-family text fields support template variables that Hyperline replaces with the corresponding value when it generates the document. Supported fields include:

* Invoice footer, additional information, and late fees
* Credit note footer and additional information
* Custom document footer and additional information
* Custom note on invoices and on the subscription invoicing options form

| Variable | Replaced with |
| - | - |
| `{{customerId}}` | The customer's Hyperline ID |
| `{{customerExternalId}}` | The customer's external ID |
| `{{subscriptionId}}` | The subscription's ID, only rendered when the invoice is tied to a subscription, otherwise hidden |
| `{{invoiceId}}` | The invoice's ID |
| `{{invoiceNumber}}` | The invoice's number |
| `{{quoteNumber}}` | The quote's number |

For example, a footer set to `Please reference {{invoiceNumber}} and subscription {{subscriptionId}} in your payment.` produces a fully populated line on subscription-generated invoices. On standalone invoices that aren't linked to a subscription, `{{subscriptionId}}` is omitted.

<Info>
  Quote footers and quote or contract templates don't support `{{subscriptionId}}`, because a quote isn't yet tied to a subscription.
</Info>


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