# Shipment list

> The Safecube shipment list shows every active shipment of the workspace in a sortable table, with tabs, search and filters to narrow it, row and bulk actions to share, edit, archive or delete shipments.

The shipment list is the main view of the Safecube platform: a table of every active shipment of the workspace, with its status, ports, ETA and last event. It opens from **Shipments** in the sidebar, whose counter gives the number of active shipments. Tabs, search and filters narrow the table, and row and bulk actions act on the shipments it shows.

## Who can do what in the shipment list

| Gesture | Minimum role |
| ------- | ------------ |
| Open the list, sort, search, filter, manage your tabs | Viewer |
| View details, share a shipment, export to CSV | Viewer |
| Add teams, edit custom data, archive a shipment | Editor |
| Select several shipments and use the selection bar | Editor |
| Delete a shipment permanently | Admin |
| Change the columns of the list | Admin |

The roles are described in [Users and roles](/en/platform/workspace/users-and-roles).

## Read the table

Each row is a shipment. The columns are shared by the whole workspace and described in [Shipment list columns](/en/platform/shipment-views/shipment-list-columns). The pill of the **Status** column is described in [Shipping statuses](/en/platform/container-tracking/shipping-statuses).

- **Open a shipment**: select its row to open the shipment details page. On a shipment blocked with a tracking issue, the row opens a panel that explains the cause instead, as described in [Tracking issues](/en/platform/container-tracking/tracking-issues).
- **Sort**: the list is ordered by status until you select a column header. The first selection sorts a date column most recent first and any other column from A to Z; selecting the same header again reverses the order. Custom columns sort as text.
- **Paginate**: the list shows 25 shipments per page by default; the bar under the table switches to 10, 25, 50 or 100 per page and shows the total, "of N shipments".
- **Export**: the **Export** button above the table exports the shipments to CSV, as described in [Sharing and export](/en/platform/container-tracking/sharing-and-export).

While the shipments load, the table shows placeholder rows. A workspace with no shipment reads "Start tracking your first shipment", with **Track a shipment**, which opens the page to add shipments ([Adding shipments](/en/platform/getting-started/adding-shipments), Editor minimum). When filters or a search match nothing, the table reads "No results found" and "No shipments match your current filters or search. Try adjusting your criteria."

![Shipment list on the All tab with 27 shipments, showing the Shipment N°, Status, Kanban, POL, POD, ETA and Last event columns and 25 rows per page](https://docs.safecube.ai/media/images/shared/shipments-list--default.webp?v=fed49048)

![Empty shipment list reading Start tracking your first shipment, with the Track a shipment button](https://docs.safecube.ai/media/images/shared/shipments-list--empty.webp?v=d81ae422)

## Use the row menu

The **…** button at the end of a row opens the actions on that shipment. The menu only lists the actions your role allows.

| Action | What it does | Minimum role |
| ------ | ------------ | ------------ |
| **View details** | Opens the shipment details page | Viewer |
| **Share shipment** | Creates a public link to the shipment ([Sharing and export](/en/platform/container-tracking/sharing-and-export)) | Viewer |
| **Add team(s)** | Adds the shipment to teams ([Teams](/en/platform/workspace/teams)) | Editor |
| **Edit your data** | Puts the custom data of the row in edit mode ([Shipment list columns](/en/platform/shipment-views/shipment-list-columns)) | Editor |
| **Archive shipment** | Moves the shipment to the Archives page ([Shipment archiving](/en/platform/container-tracking/shipment-archiving)) | Editor |
| **Delete shipment** | Deletes the shipment permanently | Admin |

![Row menu of a shipment with View details, Share shipment, Add team(s), Edit your data, Archive shipment and Delete shipment](https://docs.safecube.ai/media/images/specific/shipment-views/row-menu.webp?v=b7edb1fa)

## Switch between tabs

The tabs above the table are saved filters, each with the number of shipments it holds. The counters follow the filters and search currently applied.

| Tab | Shipments shown |
| --- | --------------- |
| **All** | Every active shipment |
| **In transit** | Shipments in transit |
| **Delayed** | Delayed shipments |
| **Delivered** | Delivered shipments |
| **Warning** | Incomplete shipments and shipments with no data found |

The statuses behind each tab are described in [Shipping statuses](/en/platform/container-tracking/shipping-statuses).

![Shipment list on the Warning tab with 7 shipments: one Incomplete, the others blocked with a tracking issue such as Wrong number, Carrier needed or Awaiting carrier](https://docs.safecube.ai/media/images/shared/shipments-list--tab-warning.webp?v=4d3bc828)

## Create, edit, hide or reorder tabs

Tabs are personal: they are saved in your browser, not in the workspace or your account. They do not follow you to another browser or computer, and no other user sees them, unlike the columns, which are shared by the whole workspace.

1. Select **+** next to the tabs ("Show, hide, reorder or create tabs"). **Your shipment tabs** opens.
2. Change the tabs:
   - **Create a tab from filters** opens **New tab**. Under "What should this tab show?", pick at least one filter among status, carrier, **Port of Discharge (POD)**, search, **ETA range** and teams. Under "Name it", type a name of 30 characters at most, unique among your tabs whatever the case. The dialog shows how many containers currently match. Select **Create tab**.
   - The pencil ("Edit filters") changes the filters and name of a tab, with **Save tab**.
   - The eye ("Hide this tab", "Show this tab") hides or shows a tab.
   - **Delete** removes a custom tab at once, without confirmation; **Undo** brings it back.
   - The handle ("Drag to reorder") or **Move up** and **Move down** change the order.
   - **Restore defaults** brings back the five default tabs.
3. Select **Save changes** to apply, or **Cancel** to discard every change.

The **All** tab cannot be hidden, edited or deleted, only moved.

## Search and filter the list

**Filters**, in the top bar, opens the filters panel; the button shows the number of active filters. Filters apply as soon as you change them, without a confirmation button.

| Field | Filters on |
| ----- | ---------- |
| **Search a shipment** | References and BL numbers ("Search references, BL number...") |
| **Carrier** | One or more carriers, by name or SCAC |
| **Status** | **Fetching data**, **Planned**, **Delayed**, **On time**, **Early**, **Delivered**, **No data found** |
| **Filter by ETA** | An ETA range, with a **Start date** and an **End date** |
| **Filter by POD** | One or more ports of discharge, by port name or code |
| **Filter by teams** | One or more teams; shown when the workspace has teams |

**Reset** brings the filters back to those of the current tab. When the filters differ from the tab, **Save as preset** opens **New tab** with the current filters, to keep them as a tab.

The same panel filters the Kanban board and the calendar. **Save as preset** only exists on the shipment list.

![Filters panel of the shipment list with the Maersk carrier and the Delayed status selected, two active filters, and the Reset and Save as preset buttons](https://docs.safecube.ai/media/images/shared/shipments-list--filters-drawer.webp?v=8dc60c92)

## Act on several shipments

1. Tick the box at the start of each row, or the box in the header to select every shipment of the current page. The selection bar appears with the number of shipments selected.
2. Choose an action:
   - **Edit** opens **Edit custom fields**: the Kanban column and one field per custom column. "Empty fields will not override existing values on the selected shipments." Select **Apply changes**.
   - **Teams** opens **Add teams to shipments**. Choose the teams, then select **Add teams**.
   - **Archive** archives the selection, as described in [Shipment archiving](/en/platform/container-tracking/shipment-archiving).
   - **Delete** deletes the selection permanently, Admin only.
3. The **X** button ("Cancel actions") clears the selection.

A Viewer has no boxes to tick and no selection bar.

![Shipment list with three shipments ticked and the selection bar showing Edit, Teams, Archive and Delete](https://docs.safecube.ai/media/images/shared/shipments-list--bulk-selection.webp?v=826dc37c)

## Delete a shipment

Deleting a shipment removes it and its data for good. To keep the shipment readable while taking it out of the active list, archive it instead.

1. In the row menu, select **Delete shipment**; for several shipments, tick them and select **Delete** in the selection bar.
2. The **Delete shipment** dialog asks "Are you sure you want to delete?" and names the shipment; for a selection, **Delete shipments** asks "Permanently delete N shipment(s)?". Both warn "This action cannot be undone. All associated data will be permanently deleted."
3. Select **Delete**.

Safecube displays "Shipment deleted successfully." or "Shipments deleted successfully.". An Editor sees **Delete** greyed out in the selection bar, with "Only admins or owners can delete shipments permanently.".

## Limits

- There is no filter on custom columns.
- A deleted shipment cannot be recovered.
- Selecting all shipments selects those of the current page only.
- Tabs are kept in the browser where they were created and are never shared with other users.
