# Adding shipments

> Shipments are added to Safecube from the Home page of a new workspace or from the Track a new shipment page, one at a time, by pasting a list or by importing a CSV file, using a container, bill of lading or booking number.

Safecube tracks a shipment from one of three references: a container number, a bill of lading number (master or house, MBL or HBL) or a booking number. Safecube detects the type of reference from the number, there is no type to choose. Shipments are added from the Home page of a workspace that has none yet, then from the **Track a new shipment** page, one at a time, by pasting a list or by importing a CSV file.

## Who can add shipments

| Gesture | Minimum role |
| ------- | ------------ |
| Add shipments from the **Track a new shipment** page | Editor |
| Create a custom field from the **Teams and custom properties** panel | Admin |

A Viewer who opens the **Track a new shipment** page is redirected to a page stating that access is forbidden. Each new shipment uses one of the workspace's shipment credits: when none is left, the creation is refused, as described in "When creation fails" on this page.

## Track your first shipment

When a workspace has no shipment yet, as right after [creating an account](/en/platform/getting-started/creating-an-account), the Home page of the Safecube platform shows a **Track your first shipment** card with two tabs:

- **Tracking number**, to add a single shipment;
- **Upload CSV**, to import several shipments from a CSV file, in the format described in "Import a CSV file" on this page.

On the **Tracking number** tab, the **Shipment number** field is required. It accepts a container number, a bill of lading (BL) number or a booking number. The **Sealine** field below it is labelled optional, except for leased containers, for which a carrier is required (see "Carrier detection and leased containers" on this page). The **Track shipment & build my dashboard** button submits the shipment.

![Home page of a workspace with no shipment: Track your first shipment card with the Tracking number and Upload CSV tabs, the Shipment number and Sealine fields, and the Track shipment & build my dashboard button](https://docs.safecube.ai/media/images/shared/home--default.webp?v=8af02c03)

The Home page stays available until the first shipment of the workspace is created, from any page of the platform. From then on, the Safecube home address opens the shipment list.

A user who followed a container on the Safecube public tracking tool before signing up is offered, on the Home page, the dialog **Continue tracking your container?**: **Track it here** adds that container to the workspace, **Not now** dismisses it.

### Accept or dismiss the carrier suggestion

When Safecube recognises the carrier from the shipment number entered on the Home page, a suggestion appears under the **Sealine** field. It shows the carrier name, its code and the reason for the suggestion, for example "Prefix MSCU" for a container number starting with MSCU. Two buttons answer it:

- **Use** fills the Sealine field with the suggested carrier;
- **Dismiss** ignores the suggestion and leaves the Sealine field empty.

As long as the suggestion is neither used nor dismissed, the **Track shipment & build my dashboard** button is disabled and the message "Accept or dismiss the carrier suggestion to continue" is displayed under it.

![Carrier suggestion under the Sealine field of the Home page: MSC with the reason Prefix MSCU, the Dismiss and Use buttons highlighted, and the Track shipment & build my dashboard button disabled above the message Accept or dismiss the carrier suggestion to continue](https://docs.safecube.ai/media/images/specific/getting-started/sealine-suggestion.webp?v=10476331)

### Find the new shipment in the shipment list

Once the first shipment is submitted from the Home page, Safecube displays the message "Shipment created successfully." and opens the [shipment list](/en/platform/shipment-views/shipment-list), not the shipment details. The new shipment appears there with the status **Identification**, followed by a counter of the seconds elapsed: Safecube is retrieving the shipment status from the carrier. The statuses a shipment takes afterwards are described in [Shipping statuses](/en/platform/container-tracking/shipping-statuses), and what to do when the identification takes long or is blocked, for example after a wrong number or carrier, in [Tracking issues](/en/platform/container-tracking/tracking-issues).

![Shipment list with one shipment, container MSCU1234566, whose status reads Identification · 1 s, and the confirmation Shipment created successfully](https://docs.safecube.ai/media/images/shared/shipments-list--resolving-pill.webp?v=fe30dfdf)

## Add one shipment

1. Open the [Track a new shipment](https://app.safecube.ai/shipments/new) page, from the **New shipment** button of the top bar. The **Single** tab is open.
2. Enter the reference in **Shipment number**. Spaces cannot be typed. A warning under the field flags a container number whose length or check digit looks wrong; it does not block the creation, and it can be ignored for a bill of lading or a booking number.
3. Optionally, choose the carrier in **Sealine**, by its name or its SCAC code. Safecube may suggest one, as described in "Carrier detection and leased containers" on this page.
4. Optionally, open **Teams and custom properties** to assign teams, a Kanban column and custom property values to the shipment.
5. Select **Track shipment**.

Safecube displays "Shipment created successfully." and opens the shipment list.

The info icon next to **Shipment number** opens the special formats required by a few carriers. The info icon next to **Sealine** opens **Shipping line SCAC code**, a searchable list of carriers and their SCAC codes.

![Single tab of the Track a new shipment page with the Shipment number and Sealine fields and the Teams and custom properties panel open](https://docs.safecube.ai/media/images/shared/shipment-create--single.webp?v=69591cda)

## Add several shipments by pasting

1. On the **Track a new shipment** page, open the **Multiple** tab. It starts with three empty rows.
2. Paste a list of numbers, one per line, into a row: the rows fill themselves. One paste adds up to 100 numbers; beyond that, the extra numbers are dropped and Safecube suggests the CSV import. **Add shipment** adds an empty row.
3. Optionally, set the teams and custom properties of the batch. They apply to every row without its own settings; a row's own settings, under **Teams and properties for this row**, replace those of the batch.
4. Answer the carrier suggestions row by row, or all at once with **Accept all** or **Dismiss all**.
5. Select **Track N shipments**, where N is the number of filled rows.

When every shipment is created, Safecube opens the shipment list. Otherwise, it shows the creation report described in "Read the creation report" on this page.

![Multiple tab with three container numbers and their carriers, and the Track 3 shipments button](https://docs.safecube.ai/media/images/shared/shipment-create--multiple.webp?v=b859b0e0)

## Import a CSV file

1. On the **Track a new shipment** page, open the **Import CSV** tab, or the **Upload CSV** tab of the Home page.
2. Select **Download template** to get the file `Safecube_Sample_Import_Shipments.csv`.
3. Fill one shipment per row, then drop the file or browse to it. Safecube displays the number of shipments detected.
4. Select **Upload file**.

Safecube displays **Creation succeeded**: the file is received and Safecube gathers the shipments' data. **View containers** opens the shipment list.

| Rule | Value |
| ---- | ----- |
| File type | `.csv` only |
| Encoding | UTF-8 |
| Separator | Semicolon (`;`) |
| Rows | Up to 500 |
| Headers | `shipmentNumber` (container, BL or booking number), `sealineCode` (carrier SCAC code, such as ONEY or MAEU), `groups` (existing team names, several between brackets separated by `\|`, such as `[Team_1 \| Team_2]`). Headers are not case-sensitive. |

When rows contain leased containers without a carrier, the dialog **Some lines need a carrier** lists them before the upload. **Import N valid lines** imports the other rows, **Download N error lines** downloads the rejected rows, and **Cancel everything** stops the import. To import them, add the SCAC code in the `sealineCode` column and import the file again.

## Carrier detection and leased containers

When the **Sealine** field is empty, Safecube tries to recognise the carrier from the shipment number:

- **Suggestion**: the carrier is shown with **Use** and **Dismiss**. The submit button stays disabled until one of them is selected. When two or three carriers are possible, Safecube lists them.
- **Conflict**: when the carrier chosen does not match the number, Safecube shows "The number looks like a" followed by the detected carrier, with **Keep** (the carrier entered) and **Replace**.
- **Unknown prefix**: the field can stay empty and Safecube tries an automatic detection, but filling in the carrier improves the chances of tracking.

A leased container is the exception. Its four-letter prefix names the leasing company that owns it, not the carrier operating it, so Safecube cannot track it without a carrier. The **Sealine** field shows **Leased container — carrier unknown**, with the carriers most often seen on that prefix when Safecube knows them. Submitting without a carrier opens the dialog **This container needs a carrier**: **Add the carrier** returns to the field. Once the dialog is closed, the field also shows **Carrier required for this leased-fleet container**. The carrier is written on the bill of lading, in the header or in the Carrier box, and on the booking confirmation sent by the freight forwarder. No credit is used until the shipment is created.

On the **Multiple** tab, a leased row without a carrier shows "This container needs a carrier to be tracked." and nothing is sent until every such row has a carrier.

![Sealine field of a leased container showing Carrier required for this leased-fleet container above the Leased container — carrier unknown card, with the three carriers most often seen on its prefix](https://docs.safecube.ai/media/images/shared/shipment-create--leasing-blocked.webp?v=9a17097f)

![This container needs a carrier dialog explaining that the prefix identifies a leasing company, with the carriers most often seen on it and the Cancel and Add the carrier buttons](https://docs.safecube.ai/media/images/shared/modal-sealine-blocked--default.webp?v=76b4abf7)

The list of carriers and their SCAC codes is in [Supported sealines](/en/platform/getting-started/supported-sealines).

## Duplicate shipments

On the **Single** and **Multiple** tabs, Safecube warns before creating a shipment whose number is already tracked in the workspace:

- for one shipment, **This Shipment Is Already Tracked** shows since when it is tracked, with **View existing shipment** and **Track anyway**;
- for several, **Duplicates Detected** lists them, each with a link to the existing shipment, with **Close** and **Track anyway**.

Tracking the same number again is useless: when **Track anyway** is selected, Safecube normally refuses the creation and displays "Container … is already tracked in your workspace." with **View shipment**. The same refusal applies to the Home page, where no warning is shown before submitting.

## Read the creation report

When a batch from the **Multiple** tab is not fully created, the **Creation report** dialog counts the shipments **created**, **with warnings** and **failed**, and lists each row with its number, its carrier code and, for a failed row, the reason. A shipment with warnings is created, but "Some custom fields could not be added." **Contact us** opens the support form when at least one row failed. Closing the report resets the tab to three empty rows.

## When creation fails

The **Creation failed** dialog explains why Safecube refused a creation:

| Message | Cause | What to do |
| ------- | ----- | ---------- |
| "Your free trial has ended. Subscribe now to continue creating shipments and tracking your containers." | The workspace has no shipment credit left | **Subscribe** opens the plans page |
| "The container number you entered is invalid. Please ensure it follows the format: ABCD1234567." | The container number is invalid | Correct the number |
| "Container … is already tracked in your workspace." | The shipment is already tracked | **View shipment** opens the existing shipment |
| "Oops! We couldn't process your file because it doesn't adhere to the required format…" | The CSV file does not follow the format of "Import a CSV file" on this page | Start again from the template |
| "An error occurred while creating the shipment…" or "Oops, an error occurred…" | Another error | Check the information and try again, or select **Contact us** |

How shipment credits are counted is described in [Shipment billing](/en/platform/billing/shipment-billing). The end of a free trial is described in [Free trial](/en/platform/billing/free-trial).

![Creation failed dialog stating that the free trial has ended, with the Close and Subscribe buttons](https://docs.safecube.ai/media/images/shared/modal-create-errors--credits.webp?v=0491f877)

## Limits

- There is no internal reference field: a shipment is identified by its number only.
- A leased container is never created without a carrier, on any tab or in a CSV file.
- The number of shipments detected in a CSV file counts every filled row, including leased containers without a carrier and invalid numbers.
- The duplicate warning only covers shipments already loaded in the workspace, on the **Single** and **Multiple** tabs.
- One paste on the **Multiple** tab adds up to 100 numbers.
