---
title: Create and Manage Billing Line Item Descriptions
url: https://docs.maxio.com/configuration/maxio-core/invoicing/setup-configuration/create-and-manage-billing-line-item-descriptions
applies_to: Maxio Core
updated: 2026-09-19
---

# Create and Manage Billing Line Item Descriptions

The Billing Line Item Description Library keeps the billing descriptions for your Items consistent. Each description is a reusable preset of Invoice text, optionally containing placeholder fields that Maxio fills in from Transaction data, so the wording customers see on an Invoice stays standard across Items.

## Who can use the library

Working with the library requires Admin permissions. Selecting an existing description while editing an Item requires only Editor permissions. The library is not available on Analytics-only accounts.

## Add a description

A description has three parts: the **Name** you select it by, the **Contents** that reach the Invoice, and **Notes** for your own reference.

**To add a billing line item description**

1. Click **Billing Line Item Description Library** in the **Invoicing** section of the Admin screen.

2. Click **Add** in the top-right corner.

   ![Billing Line Item Description Library screen, showing the default descriptions and the description list](https://docs.maxio.com/content-images/configuration/maxio-core/invoicing/setup-configuration/create-and-manage-billing-line-item-descriptions/45279653240077_Admin_Invoicing_BillingLineDescriptionLibrary.png)
3. Complete the following fields:
   - **Name** - The name that identifies this description elsewhere in Maxio.
   - **Contents** - The text that appears on the Invoice. To add a placeholder field, choose it from the **Choose a Field** drop-down above the form and click **Insert**.
   - **Notes** - Any details you want to record about the description. Notes never appear on an Invoice.

   ![Create Billing Description screen, with the Available Placeholder Fields picker above the Name, Contents, and Notes fields](https://docs.maxio.com/content-images/configuration/maxio-core/invoicing/setup-configuration/create-and-manage-billing-line-item-descriptions/45279668530829_Admin_Invoicing_CreateBillingDescription.png)
4. Click **Save** at the bottom of the screen.

You can then select this description when <a href="https://docs.maxio.com/configuration/maxio-core/admin-lists/items/add-edit-and-remove-items" target="_blank" rel="noopener noreferrer">creating or editing an Item</a>.

### Placeholder fields available in the picker

The **Choose a Field** drop-down groups the available placeholders by the record they draw from: Transaction, Item, Contract, and Billing Method. Each Transaction custom field on your account also appears in the Transaction group, listed by its Display Name.

Two entries depend on your configuration. **QuickBooks Default Item Description** appears only when the QuickBooks integration is enabled, and custom field placeholders appear only for fields your account has set up. For the full list of placeholders and what each one inserts, see <a href="https://docs.maxio.com/configuration/maxio-core/invoicing/setup-configuration/reference-placeholder-fields" target="_blank" rel="noopener noreferrer">Reference Placeholder Fields</a>.

## Item description examples

These examples show wording that works well for common billing arrangements.

| Situation | Examples |
| :--- | :--- |
| Recurring Items | <ul><li>This is your subscription fee for {transaction_item} for the term starting {transaction_start_date} and ending {transaction_end_date}.</li><li>This is your annual subscription fee for {transaction_item} for the term starting {transaction_start_date}.</li></ul> |
| Annual subscription invoiced periodically, quarterly or monthly | <ul><li>This is your subscription fee for {transaction_item} for the term starting {transaction_start_date} and ending {transaction_end_date}. This invoice billing period is from {invoice_billing_period_start_date} through {invoice_billing_period_end_date}.</li><li>This is your {billing_method_invoicing_frequency} invoice for your subscription for the term from {transaction_start_date} through {transaction_end_date}.</li><li>Your subscription fee for {transaction_item} for the term starting {transaction_start_date} and ending {transaction_end_date}. You are being billed {billing_method_invoicing_frequency}.</li><li>This is this {billing_method_invoicing_period}'s invoice for your {transaction_item} subscription for the term period {transaction_start_date} through {transaction_end_date}.</li></ul> |
| Quarterly subscriptions billed in advance | <ul><li>Your {transaction_item} subscription invoice for the term {transaction_start_date} through {transaction_end_date}.</li></ul> |
| Quarterly subscriptions billed monthly | <ul><li>Your {transaction_item} quarterly subscription for the billing period {invoice_billing_period_start_date} through {invoice_billing_period_end_date}.</li></ul> |
| Monthly subscription | <ul><li>Your {transaction_item} subscription invoice for the period {invoice_billing_period_start_date} through {invoice_billing_period_end_date}.</li><li>This is your {transaction_item} subscription invoice for the month beginning {invoice_billing_period_start_date}.</li></ul> |
| Non-recurring | <ul><li>For Professional services rendered.</li><li>For services rendered.</li><li>Training and implementation fees.</li><li>Set up fee invoice. You are being billed {billing_method_invoicing_frequency}.</li></ul> |

## Set default descriptions

You can nominate one description as the default for recurring Items and another for non-recurring Items. When you create an Item, Maxio fills in the matching default according to the Item's recurrence setting.

**To set the default descriptions**

1. Click **Defaults** in the top-right corner of the Billing Line Item Description Library screen.
2. Select a description from the **Recurring Items** and **Non-Recurring Items** drop-down menus.

   ![Set Default Billing Descriptions screen, with drop-downs for Recurring Items and Non-Recurring Items](https://docs.maxio.com/content-images/configuration/maxio-core/invoicing/setup-configuration/create-and-manage-billing-line-item-descriptions/45279668530957_Admin_Invoicing_SetDefaultBillingDescription.png)
3. Click **Save**.

Your selections then appear in a **Default Billing Descriptions** table at the top of the library screen, showing each one's Item Type, Preset Name, Contents, and Notes.

If an Item has no Billing Description of its own, Maxio falls back to the Item's QuickBooks description, and leaves the line blank if there is none.

## Edit, clone, or delete a description

Use the menu icon next to a description in the library to reach these options.

![Description menu, showing the Edit, Clone, and Delete options](https://docs.maxio.com/content-images/configuration/maxio-core/invoicing/setup-configuration/create-and-manage-billing-line-item-descriptions/45279668531213_Admin_LineItemDescriptions_EditCLoneDelete.png)

*The Billing Line Item Description Library, with its default descriptions*

> **WARNING:** Deleting a description cannot be undone, and if that description is set as your recurring or non-recurring default, the default is cleared at the same time. Items already created with the description keep their wording, because the description's text is copied onto the Item rather than linked to it.

- **Edit** - Change the description's name, contents, or notes.
- **Clone** - Copy an existing description as the basis for a new one. This opens the Clone Billing Description screen with the original's values already filled in.
- **Delete** - Remove the description from the library.
