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

# Split and move parcels

> Split Shipment, Redistribute Parcels, and Move to shipment — every field, quantity split, and when each button shows.

Three different actions live on **Package Details**. They are easy to mix up:

| Action                   | What it does                                                             | New shipment?              |
| ------------------------ | ------------------------------------------------------------------------ | -------------------------- |
| **Split Shipment**       | Move **this package’s** order lines onto one or more **new shipments**   | Yes                        |
| **Redistribute Parcels** | Move order lines **between parcels on this shipment** (add/remove boxes) | No                         |
| **Move to shipment**     | Move the **whole package** onto another shipment of the **same order**   | No (target already exists) |

Split and redistribute are only on **Draft** or **Pending**. Move also works on **Error**. After **Dispatched**, all three are hidden. [Hold, cancel, or delete](/docs/how-to/hold-cancel-and-delete-shipments).

Related journey: [Create a shipment](/docs/tutorials/create-a-shipment).

## Package Details

Card title: **Package Details**. Empty: **No packages** / **This shipment has no packages**.

Columns:

| Column          | Content                                                                                                                                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Package**     | `#1`, `#2`, …                                                                                                                                                                                                                        |
| **Weight**      | Value + unit (`kg` / `g` / `lb` / `oz`)                                                                                                                                                                                              |
| **Dimensions**  | `length × width × height cm`                                                                                                                                                                                                         |
| **Order Lines** | SKU or description, **Qty: {{count}}**, unit price + currency, **VAT: {{percent}}%**, location, country of origin, **Tariff: {{number}}**. **No order lines** when empty. **Edit package** while the shipment is draft/pending/error |
| **Tracking**    | Only when status is **Dispatched** — number, **Track**, label-free code, **QR Code**                                                                                                                                                 |

Header right: **Redistribute Parcels** (see show/hide below).

<Frame caption="Package Details on a pending multi-parcel shipment — Redistribute Parcels, Split Shipment, Edit package">
  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/01-package-details-light.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=bb192a3b39555a321c82768bf0d2dd9e" alt="Package Details with two packages, Split Shipment, Redistribute Parcels, and Edit package" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/01-package-details-light.png" />

  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/01-package-details-dark.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=ec13daa62c09d3c93d97dba47669db0b" alt="Package Details with two packages, Split Shipment, Redistribute Parcels, and Edit package" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/01-package-details-dark.png" />
</Frame>

On an **order** **Shipments** tab, the same table is embedded on each card. **Move to shipment** is only there (it needs a sibling shipment).

## When buttons show or hide

| Control                                   | Shows when                                                                                                                                                   |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Split Shipment** (per package)          | Shipment is **Draft** or **Pending**, **and** that package has more than one order line **or** any line with quantity > 1                                    |
| **Redistribute Parcels**                  | Shipment is **Draft** or **Pending**, **and** the shipment has at least **two** order lines in total (across all packages)                                   |
| **Move to shipment**                      | Shipment is **Draft**, **Pending**, or **Error**, you are on the **order** Shipments tab, **and** another shipment on that order is also draft/pending/error |
| **Edit package**                          | **Draft**, **Pending**, or **Error**                                                                                                                         |
| **Split** on a line card (inside a modal) | That line’s **quantity > 1**                                                                                                                                 |

Hidden examples: a pending shipment with one line of qty 1 has **no** Split Shipment and **no** Redistribute Parcels. A dispatched shipment has neither. Move never appears on a standalone shipment with no order.

## Split Shipment

Opens from the package row. Modal title: **Split Shipment**. Subtitle: **Move order lines between shipments**. Helper: **The original shipment stays on the left. Empty new columns are ignored when you split.**

Confirm: **Split Shipment** / **Splitting…**. Disabled reasons:

* **Move at least one line into a new shipment**
* **Fix quantity mismatch before splitting**
* **Splitting in progress**

Cancel: **Cancel**.

**Shipment Board** — **Drag cards to move everything, or use split for partial quantities.**

Counts: **{{count}} card(s)**, **{{count}} item(s)**, **{{count}} new shipment(s)**. Button: **Add shipment**.

Columns:

| Column                      | Fields                                                                |
| --------------------------- | --------------------------------------------------------------------- |
| **Original Shipment**       | Cannot be removed. Lines you leave here stay on this shipment         |
| **New Shipment {{number}}** | Optional **Reference (optional)**. Trash = **Remove shipment column** |
| Dashed **Add shipment**     | **Create a new empty column.**                                        |

Empty column: **Drop lines here**. Footer of a column: **{{count}} line(s) · {{count}} item(s)**.

Error banner **Cannot split yet**: **Quantity mismatch for order line. Expected {{expected}}, but total across shipments is {{actual}}.**

Toasts: **Shipment split successfully. A new shipment has been created.** / **…New shipments have been created.** / **Failed to split shipment**.

<Frame caption="Split Shipment board — Original Shipment on the left, empty New Shipment 1, Add shipment">
  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/02-split-shipment-modal-light.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=1057628f70d582ed1f19c53aea5dd4d4" alt="Split Shipment modal with original and new shipment columns" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/02-split-shipment-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/02-split-shipment-modal-dark.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=722e307c0345eef617bf4e7557cbeba3" alt="Split Shipment modal with original and new shipment columns" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/02-split-shipment-modal-dark.png" />
</Frame>

### Split quantity (partial line)

On a card with qty > 1, **Split** opens a popover:

| Field                     | Meaning                                               |
| ------------------------- | ----------------------------------------------------- |
| Title                     | **Split {{sku}}**                                     |
| **Quantity to split off** | Number, min 1, max qty − 1, shown **/** **{{total}}** |
| Hint                      | **Keeps {{keep}}, splits off {{split}}**              |

Default split quantity is half (floored). Confirm keeps some units on the source card and creates a new card with the split-off qty that you can drag to another column.

<Frame caption="Split quantity popover — Quantity to split off, keeps vs splits off">
  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/03-split-quantity-light.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=fa9dd5037b9b2f1f9a010db51ce2de17" alt="Split quantity popover on an order line with quantity greater than one" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/03-split-quantity-light.png" />

  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/03-split-quantity-dark.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=55b0a0d7c6752d39d7f2a6d77fe85a63" alt="Split quantity popover on an order line with quantity greater than one" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/03-split-quantity-dark.png" />
</Frame>

## Redistribute Parcels (split parcel)

This is the “split parcel” action. It does **not** create a shipment. Modal title: **Redistribute Parcels**. Subtitle: **Move order lines between parcels within this shipment**. Helper: **Drag order lines between parcels. Empty parcels are ignored when you save.**

Confirm: **Save Parcels** / **Saving…**. Disabled reasons:

* **Move at least one line to a different parcel**
* **Fix quantity mismatch before saving**
* **Saving in progress**

**Parcel Board** — same drag/split help as the shipment board.

Counts: cards, items, **{{count}} parcel(s)**. **Add parcel** — **Create a new empty parcel.**

Columns: **Parcel {{number}}** (existing) and **New Parcel {{number}}** with a **New** badge. Remove: **Remove parcel**.

Mismatch: **Quantity mismatch for order line. Expected {{expected}}, but total across parcels is {{actual}}.** (**Cannot save yet**).

Toast: **Parcels redistributed successfully.** / **Failed to redistribute parcels**.

<Frame caption="Redistribute Parcels — Parcel Board with existing parcels and Add parcel">
  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/04-redistribute-parcels-light.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=81bf8c7708440f23c4725c0430d56519" alt="Redistribute Parcels modal with parcel columns and order line cards" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/04-redistribute-parcels-light.png" />

  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/04-redistribute-parcels-dark.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=40c7c649cc473c5da8174cffda5114fb" alt="Redistribute Parcels modal with parcel columns and order line cards" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/04-redistribute-parcels-dark.png" />
</Frame>

**Split** on a line works the same as in Split Shipment.

## Move to shipment

Only on the order **Shipments** tab. Tooltip: **Move this package onto another shipment on the same order**.

Click **Move to shipment** — dropdown of sibling shipment **references**. No extra fields. Disabled while a move is in flight.

Toasts: **Package moved to the other shipment.** / **Failed to move the package**.

If the source shipment has no parcels left after the move, treat it as empty — send or delete it separately ([Hold, cancel, or delete](/docs/how-to/hold-cancel-and-delete-shipments)).

<Frame caption="Move to shipment lists the other pending shipment on the same order">
  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/05-move-to-shipment-light.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=861db6850c9db0fe709dcb48b6bf854d" alt="Order shipment card with Move to shipment menu listing a sibling shipment reference" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/05-move-to-shipment-light.png" />

  <img src="https://mintcdn.com/zippendo/80e9oqVywBPyYyWf/images/how-to/split-and-move-parcels/05-move-to-shipment-dark.png?fit=max&auto=format&n=80e9oqVywBPyYyWf&q=85&s=1bc1dc3a1a04890db997b5458acef624" alt="Order shipment card with Move to shipment menu listing a sibling shipment reference" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/split-and-move-parcels/05-move-to-shipment-dark.png" />
</Frame>

<Check>
  Use **Redistribute Parcels** when the same booking should have two boxes. Use **Split Shipment** when the rest should be a separate label. Use **Move to shipment** when the box already belongs on another shipment of this order.
</Check>
