NewMaxio Metering is now available — usage-based billing for Advanced Billing.Learn more
/

Create and Manage Billing Line Item Descriptions

··

Last updated on Sep 19, 2026

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

  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

  4. Click Save at the bottom of the screen.

You can then select this description when creating or editing an Item.

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 Reference Placeholder Fields.

Item description examples

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

SituationExamples
Recurring Items
  • This is your subscription fee for {transaction_item} for the term starting {transaction_start_date} and ending {transaction_end_date}.
  • This is your annual subscription fee for {transaction_item} for the term starting {transaction_start_date}.
Annual subscription invoiced periodically, quarterly or monthly
  • 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}.
  • This is your {billing_method_invoicing_frequency} invoice for your subscription for the term from {transaction_start_date} through {transaction_end_date}.
  • 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}.
  • 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}.
Quarterly subscriptions billed in advance
  • Your {transaction_item} subscription invoice for the term {transaction_start_date} through {transaction_end_date}.
Quarterly subscriptions billed monthly
  • Your {transaction_item} quarterly subscription for the billing period {invoice_billing_period_start_date} through {invoice_billing_period_end_date}.
Monthly subscription
  • Your {transaction_item} subscription invoice for the period {invoice_billing_period_start_date} through {invoice_billing_period_end_date}.
  • This is your {transaction_item} subscription invoice for the month beginning {invoice_billing_period_start_date}.
Non-recurring
  • For Professional services rendered.
  • For services rendered.
  • Training and implementation fees.
  • Set up fee invoice. You are being billed {billing_method_invoicing_frequency}.

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

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

For every placeholder you can insert and what each one produces, see the Reference Placeholder Fields help article.

Still need help?
Reach out and our support team will take it from here.

Contact support