The old way of tracking an ocean shipment usually means an email to your forwarder, a wait for a reply, and a status update that's already a day or two stale by the time it lands in your inbox. None of that is necessary. Every ocean shipment throws off a trail of real events — booked, gated in, loaded, departed, discharged, released — and you can watch that trail directly if you know what number to use and where to look.
What you need before you can track anything
To track an ocean shipment you need one of three reference numbers: the booking number, the bill of lading (B/L) number, or the container number. Each one unlocks a different level of detail, and knowing which one you have determines which tool actually works for your shipment.
- Booking number — assigned once the carrier confirms space on a vessel, before the container is even loaded. Useful early, before a container number exists.
- Container number — the 4-letter, 7-digit code stencilled on the box (for example, a format like ABCU1234567). This is the most precise way to track, since it follows the physical container through gate-in, loading, transshipment, and discharge.
- Master bill of lading (MBL) — the carrier's contract for the vessel booking. This is what shows up on the carrier's own tracking page.
- House bill of lading (HBL) — your forwarder's contract with you, common on consolidated LCL shipments where several shippers' cargo travels under one master booking. If you only have an HBL number, the carrier's own site won't recognize it — you'll need your forwarder's tracking view instead.
If you're not sure which number you have, look at the document itself: a carrier-issued MBL will show the carrier's SCAC code as a prefix; a forwarder's HBL usually carries the forwarder's own reference format.
The four places you can actually check status
There are four channels for ocean tracking, and they don't all show the same thing. Carrier websites are the most authoritative for vessel-level events, terminal and port systems are best for gate and customs status, forwarder platforms aggregate everything into one view, and third-party trackers are convenient but often lag the primary sources.
| Channel | What it shows | Limitation |
|---|---|---|
| Carrier's own tracking page | Vessel schedule, loading/discharge events, container moves | Only for that one carrier; needs MBL or container number |
| Terminal / port authority system | Gate-in/gate-out timestamps, yard status | Port-specific interface; doesn't show customs status |
| Freight forwarder's platform | Consolidated view across carriers and legs | Depends on how often the forwarder updates it |
| Third-party container trackers | Multi-carrier lookup by container number | Often pulls data on a delay; not always real-time |
For a shipment with a single carrier and no transshipment, the carrier's own page is usually enough. Once a shipment involves a transshipment port, a different vessel for the second leg, or a consolidated LCL move, a single-source tracker stops being reliable — that's when a consolidated view matters most.
Reading ocean freight milestones — what each status actually means
An ocean shipment moves through a predictable sequence of milestones, and each one tells you something different about where the cargo physically is. Knowing the sequence lets you tell a normal transit gap from an actual delay.
| Booking confirmed | Carrier has allocated space; no container assigned yet |
|---|---|
| Container gated in (export) | Loaded container has entered the origin terminal |
| Loaded on vessel | Container is physically on board |
| Vessel departed | Sailing has begun; ETA now applies |
| Transshipment (if applicable) | Container is discharged and reloaded onto a connecting vessel |
| Vessel arrived / discharged | Container is off the vessel at destination terminal |
| Customs status | Lifecycle: not started → clearing → released (or held) |
| Container gated out (import) | Container has physically left the terminal |
| Empty returned | Empty container is back with the carrier; move complete |
Two of these deserve extra attention. Transshipment is where trackers most often go quiet — the container changes vessels at an intermediate port, and if the tracker is tied to the first vessel's schedule, it can look "stuck" for days when it's actually moved. And customs status is separate from the vessel schedule entirely: a container can be fully discharged and gated out of the vessel side of the terminal while customs still shows "clearing," which is what actually determines when you can collect the cargo.
Why tracking by ETA alone gets you blindsided
Vessel ETA is a single data point, and it's the least reliable one to plan around. It changes with weather, port congestion, and schedule reshuffling, and it tells you nothing about what happens after the vessel berths. The events that actually matter for cost and timing are gate events and customs status — not the ETA.
This matters most for demurrage and detention exposure. Demurrage free time typically starts counting from vessel discharge, not from ETA — it's the clock on a loaded container sitting inside the terminal before pickup. Detention free time is a separate clock: it starts once the container is picked up, and it's the empty-return window before the carrier expects the box back. Free days on either clock commonly run in the range of 3–7 calendar days depending on the carrier and port. If you're only watching the ETA and not the actual discharge and pickup timestamps, you can lose one or two of those free days before you've even started counting.
Common tracking mistakes
- Tracking only at the booking level. A booking number tells you a shipment exists; it doesn't tell you which vessel a container ended up on after a transshipment or a carrier-initiated roll.
- Missing the transshipment leg. Checking the origin carrier's tracker after the container has moved to a connecting vessel shows stale data, not a delay.
- Not confirming the free-time start date. Assuming free time starts at ETA instead of actual discharge, or at booking instead of gate-out, costs real days off your buffer.
- Relying on emailed PDFs instead of live status. A status update from three days ago is not the same as the current gate and customs status.
- Ignoring customs status as a separate track. A container can clear the terminal gate mechanically while customs shows "held" — the two systems don't always update in sync.
How to track proactively instead of reactively
Set up alerts on the milestones that actually change your plan — vessel departure, discharge, and customs status changes — rather than checking status manually every few days. The goal is to see a change the moment it happens, not to go looking for one.
Coordinate with your customs brokerage partner as soon as the vessel departs, not after it arrives — pre-filing means the "clearing" stage starts as early as the rules allow, instead of after the container is already sitting in the terminal accruing free-time days. And if a shipment involves multiple legs or a consolidation, work from a single consolidated view rather than piecing together updates from a carrier page, a terminal page, and a forwarder email — that's exactly the kind of fragmentation that turns tracking into chasing.
Setting realistic expectations before you even book
Ocean transit time is indicative, not fixed, and it's always confirmed at booking against the actual vessel schedule. As a rough guide, short-haul ocean lanes (under roughly 2,000 km) typically run around a week, medium-haul lanes (up to roughly 8,000 km) around three weeks, long-haul lanes (up to roughly 16,000 km) around five weeks, and the longest routings can run out to around six to seven weeks. If you want a quick indicative figure for a specific origin-destination pair before you book, the free Route Calculator resolves two cities to their nearest gateways and gives an indicative transit time — it's not a pricing tool, just a planning reference.
Knowing the expected range before the shipment sails makes it much easier to tell, once it's moving, whether a gap between milestones is normal transit time or an actual problem worth chasing down.
How Holo Cargo helps
Every shipment booked through Holo Cargo is tracked against its milestones automatically, so you see the moment a status changes — gated in, loaded, departed, discharged, customs cleared — instead of asking for an update. Our operators watch the same view and flag anything that looks like a delay before it turns into a demurrage clock running against you. See how a shipment moves end-to-end to understand where these milestones fit into the full booking process.
