# Grouping cartons

## TL;DR

<p class="callout info">This page covers joining several packing rows into one carton group, and taking a group apart again. Before you group anything, know that ungrouping clears gross weights and never puts back the ones the rows had before, so they must be typed in again.</p>

## What this is for

Sometimes several small items ship together in one physical box. Grouping joins their packing rows into one **carton group**: one shared carton type, one shared gross weight, one box.

Like everything on the packing screen, grouping happens in the browser and is stored only when you select **Save**. See [How packing works](/books/packaging/page/how-packing-works).

## Which rows can be grouped

Only rows with **exactly 1 total carton**: a single box each. Selecting anything else shows "Only items with exactly 1 total carton can be merged.".

At least **2 rows** must be selected: "You must select at least 2 items to create a group.". All rows must belong to the same packing list.

## Grouping rows

1. Tick the rows to combine. A **Group Selected** button appears above the table.
2. Select it. The "Group Selected Rows" dialog opens.
3. Either create a new group, or add the rows to one that exists. For a new group, pick the **Carton Type** and enter the box's **Gross Weight (kg)**. For an existing one, use **Select Existing Group**, where groups are listed as "Group #7 — Master Carton (3 rows, 12.5 kg)".
4. Select **Apply Group**. You see "Grouped locally.", and it is held in the browser until Save, like everything here.

Grouped rows show a green badge with the group's number and carton name (for example "#7 Master Carton") and share one carton and one gross weight. A group's carton or weight can be changed later through its edit control, which opens the "Edit Carton Group" dialog; confirming shows "Group updated locally.".

**Grouping rewrites the rows.** Each member's carton count becomes 1 and its pieces-per-carton becomes its full quantity, and each member's own gross weight is replaced by the group's shared weight.

## Ungrouping, and what it costs

<div class="callout warning">
<p><strong>IMAGE PLACEHOLDER: grouping-cartons-ungroup-01</strong> · infographic · status: pending</p>
<p><strong>Shows:</strong> rows combined into one box, and gross weights dropping to zero when the group is taken apart</p>
<p><strong>Must include:</strong> three single-carton rows joining into one group box with one shared gross weight; the reverse arrow showing the group taken apart, with every affected row's gross weight reset to zero and marked as needing re-entry; a note that the weights from before grouping are not brought back</p>
<p><strong>Must not show:</strong> real product names or weights presented as real data</p>
<p><strong>Alt text (draft):</strong> Three single-carton rows combine into one group box sharing one gross weight. When the group is taken apart, the affected rows return as separate cartons, but their gross weights are reset to zero and must be typed in again. The weights they had before grouping are not brought back.</p>
</div>

To take a row out of its group, select the unlink control on the row. The dialog asks "Unlink Row from Group?" with "This row will become ungrouped.", and offers **Yes, unlink!** and **Cancel**.

<p class="callout warning"><strong>Weights are cleared, and not only on one row.</strong> What happens depends on which row you unlink, and neither case can be undone.</p>

What happens depends on which row you unlink:

- Unlinking the group's **first row**, or unlinking when the group has only two rows, dissolves the whole group, and **every member's gross weight is set to zero**.
- Unlinking any other row from a larger group frees only that row, and **that row's gross weight is set to zero**.

The weights the rows had before grouping are **not brought back**. The system remembers each row's earlier carton and carton count and restores those, but the gross weight is deliberately reset to zero in every case. Every cleared weight must be typed in again, and until then the invoice cannot be marked complete.

Removing or editing a grouped row has the same side effect: the row leaves its group first, with the same weight-clearing rules.

## Errors and dialogs you may see

| What happened | What you see |
|---|---|
| A selected row has more than one carton | "Only items with exactly 1 total carton can be merged." |
| Fewer than two rows selected | "You must select at least 2 items to create a group." |
| Removing a row from its group | "Unlink Row from Group?", then "This row will become ungrouped.", with **Yes, unlink!** / **Cancel** |
| Group applied | "Grouped locally." |
| Row unlinked | "Unlinked locally." |
| Group's carton or weight changed | "Group updated locally." |

## What happens behind the scenes

- The group's number in the badge is the system's own number for the group. It is not a box number and does not print on paperwork.
- Before grouping, each row's carton, carton count and pieces-per-carton are remembered, and ungrouping restores them. The gross weight is remembered too, but never restored; zero wins.
- A group whose rows have all left it disappears on the next Save.
- Changing a line's dispatch quantity on the invoice also strips its packing row out of any group, with the same zeroed weight. See the Invoices part of this guide.

## FAQs

<details>
<summary>Why can't I group the rows I selected?</summary>
<p>Only rows with exactly 1 total carton can be grouped, at least 2 rows must be selected, and all rows must belong to the same packing list. Selecting anything else shows the matching refusal message.</p>
</details>

<details>
<summary>I unlinked one row, so why did every row's gross weight go to zero?</summary>
<p>Unlinking the group's first row, or unlinking when the group has only two rows, dissolves the whole group and sets every member's gross weight to zero. Unlinking any other row from a larger group clears only that row's weight.</p>
</details>

<details>
<summary>Does ungrouping bring back the weights the rows had before?</summary>
<p>No. The system restores each row's earlier carton and carton count, but the gross weight is deliberately reset to zero in every case, and it cannot be undone. Every cleared weight must be typed in again, and until then the invoice cannot be marked complete.</p>
</details>

<details>
<summary>Is the number in the green badge the box number on the paperwork?</summary>
<p>No. It is the system's own number for the group; it is not a box number and does not print on paperwork.</p>
</details>

<details>
<summary>Why did a row leave its group without me touching the packing screen?</summary>
<p>Changing a line's dispatch quantity on the invoice strips its packing row out of any group, with the same zeroed gross weight. Removing or editing a grouped row also makes it leave its group first, under the same weight-clearing rules.</p>
</details>

<details>
<summary>Is a group stored as soon as I see "Grouped locally."?</summary>
<p>No. Like everything on the packing screen, grouping happens in the browser and is stored only when you select Save.</p>
</details>

## Related pages

- [How packing works](/books/packaging/page/how-packing-works): the browser-held working area
- [Building a packing list](/books/packaging/page/building-a-packing-list): the rows this page groups
- [Finding packing lists](/books/packaging/page/finding-packing-lists): the list screen

*Last verified: 31 July 2026*