> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/revenue/quotes/group-line-items-on-a-quote-or-invoice.md).

# Group line items on a quote or invoice

Groups let you organize a long quote or invoice into titled sections — for example "Fire Alarm Deficiencies" and "Sprinkler Deficiencies" — so the customer reads the document by system instead of one flat list. Group headings appear in the editor, on the document preview and PDF, and on the page the customer signs or pays from. Totals and tax are unchanged by grouping; it only changes how the lines are presented.

## Turn on grouping

1. Open the quote or invoice and find the **Group items** switch above the line items.
2. Turn it on, then click **New group**, type a name, and add the group.
3. Drag line items into the group, or click **+ Add item** inside a group to add a new line directly to it.

Items you have not put in a group collect in an **Other** section at the end of the document. If nothing is assigned to any group, the document renders as a normal flat list with no section headings.

If the selected quote or invoice document template does not support group headings, Essential warns you below the **Group items** switch. Users with document-template source-edit access can open the correct Settings page from the warning; other users should ask an administrator to update the template before the document is sent.

## Rename, reorganize, or remove groups

* Hover over a group heading to reveal the rename (pencil) and delete (trash) icons.
* Deleting a group never deletes its line items — they move to the ungrouped **Other** section.
* Drag items between groups at any time to reorganize the document.

## Where groups come from automatically

When you create one quote from several deficiency tasks (see [Working a deficiency task](/field-operations/deficiencies/working-a-deficiency-task.md)), Essential creates a group per inspection report type automatically—for example, one group per asset group type inspected—and files the generated lines under them. You can rename or reorganize these like any other group before sending.

When you convert a signed quote into an invoice, its groups carry over.

> **Where to find it:** Open a quote or invoice → the **Group items** switch above the line items

## Related guides

* [Add a line item to a quote](/revenue/quotes/add-a-line-item-to-a-quote.md)
* [Turn a signed quote into an invoice](/revenue/quotes/turn-a-signed-quote-into-an-invoice.md)
* [Working a deficiency task](/field-operations/deficiencies/working-a-deficiency-task.md)
* [Choose and customize your quote document template](/administration/settings/choose-and-customize-your-quote-document-template.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.withessential.com/revenue/quotes/group-line-items-on-a-quote-or-invoice.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.