← Back to Home

Getting Started with Container Tracker for Shopify

Container Tracker follows your inbound ocean containers right in the Shopify admin. Enter a container number on an order or draft order, and the app checks the carrier for events, milestones and the arrival date (ETA). All containers are listed in one place, so you can see what arrives this week and what needs attention.

This guide walks you through setup and every part of the app. Answers to common questions are in the FAQ.

1. Install the app

  1. Open the CTMS Container Tracker listing on the Shopify App Store and click Install.
  2. Review the access screen and confirm. Container Tracker does not ask for access to your customers, products or order contents.
  3. The app opens on its Home page with a short setup guide. You start on the Free plan; no settings or carrier accounts are needed.

You find the app later under Apps → Container Tracker in the admin's left menu. Its pages are Home, Containers, Plan, Settings and Help.

2. Add the block to the order page

The Container Tracker block shows the containers of an order on the order page itself. You add it once, and it then appears on every order.

  1. Go to Orders and open any order.
  2. Scroll to the Blocks section, click + Block and choose Container Tracker.
Blocks section of an order page with the + Block button and Container Tracker in its menu
Blocks section on the order page: + Block → Container Tracker.
  1. The block appears with a Preview label. Click the pin icon (Pin to page for all staff) so the block stays on every order for everyone on your team.
Container Tracker block in preview with the pin icon and its tooltip, Pin to page for all staff
Pin the block so it shows on every order.

Draft orders have their own block. Open any draft order and add and pin Container Tracker the same way.

No block? You can also use More actions → Track container at the top of any order or draft order. It opens the same form in a window.

3. Track a container

From an order or draft order

  1. In the Container Tracker block, click Track a container.
  2. Enter the container number, for example MSKU1234565 (4 letters and 7 digits; spaces and dashes are removed). If the last digit doesn't match the standard check digit, the form warns you about a possible typo.
  3. The carrier is detected from the prefix and selected for you. Change it if the container sails with another line, which happens with leased containers.
  4. Click Track container.

The container is now linked to this order and shows in the block with its carrier, ETA and status. The first update from the carrier usually takes a few minutes.

Order page with the Container Tracker block listing three linked containers with carrier, ETA and status
An order with three linked containers.

One container can belong to several orders. If you enter a number that is already tracked, it is linked to the new order as well, and no extra container is used from your plan.

From the app

On the Containers page, click Track container, enter the number and carrier, and confirm. Containers tracked here are not linked to an order; to link one later, enter the same number in the block of that order.

4. The container page

Click a container number in the order block or on the Containers page to open its page in the app. It has these parts:

Container page for an MSC container: Arriving soon status, ETA, route Yantian to Long Beach and the event timeline
Status and timeline of a container.
Milestones checklist next to an AI summary that describes the container's journey and arrival date in plain words
Milestones and the AI summary.

5. The Containers page

The Containers page lists every container of your store with its carrier, status, last event, ETA and linked order.

Containers page listing eight ocean containers with carrier, status badge, last event, ETA and linked order
All containers in one list.

What the statuses mean

StatusMeaning
Waiting for first updateJust added; the carrier hasn't returned events yet.
In transitOn its way; the ETA is more than 7 days away or not known yet.
Arriving soonThe ETA is within the next 7 days.
ArrivedThe ETA has passed and the carrier reported events after it.
Past ETAThe ETA has passed with no newer event from the carrier. Shown under Needs attention.
No carrier dataTwo days after adding, the carrier still has no events for this number. Check the number and the carrier. Shown under Needs attention.
No events yetA carrier without automatic tracking, and no events added yet.
CompletedThe journey is finished and the carrier is no longer checked.
Status unavailableThe events couldn't be loaded just now. Try Refresh later.

6. Carriers without automatic tracking

Containers from MSC, Maersk, Hapag-Lloyd, CMA CGM, ONE, Yang Ming and Evergreen are tracked automatically. For other carriers, such as COSCO, HMM and ZIM, you track the container yourself. In the carrier list these are grouped under Manual tracking. They are free and don't count toward your plan's container limit. The Help page in the app always shows the current list.

Add events by hand

  1. Open the container page and click Add event.
  2. Pick the event (for example Received at Terminal), then enter the location, date and, optionally, the time and container type.
  3. Optionally fill in the shipment details (vessel, voyage, ports) and remarks, then click Save.

The event appears in the timeline and the milestones update. You can edit or delete events you added.

Import events from a screenshot

  1. Open the container on the carrier's tracking website.
  2. Take a screenshot that shows the container number and the list of events.
  3. On the container page in the app, under Import events from a screenshot, paste it (Ctrl+V or Cmd+V) or drop the image file (PNG, JPG or WebP).
  4. Check the preview and click Import events. Reading the screenshot takes 10 to 30 seconds.

AI reads the events, dates, locations and vessels from the image and adds them to the timeline. Each import uses 1 AI credit. The import is also offered for automatically tracked containers that have no carrier data yet.

COSCO container page with a screenshot of the carrier's tracking page, ready to import as events
A screenshot of the carrier's page, ready to import.

7. Home, plan and usage

The Home page shows:

App home with counts of active containers, arrivals in the next 7 days and containers needing attention, plus plan usage
The app's Home page.

Plans

PlanPriceIncludes
Free$010 automatically tracked containers (one-time allowance), 300 AI credits
Pro$15 per month, or $150 per year20 new automatically tracked containers per month, 400 AI credits per month

Containers from carriers with manual tracking are free on every plan. A container counts once, however many orders it is linked to. Plans are billed by Shopify on your Shopify invoice. To change your plan, open Plan in the app and click See plans. Your containers and their history stay when you change plans. The Plan page shows your current limits and when your usage resets.

8. Settings and help

Need help?

Read the FAQ, or email us at support@get-ctms.com. Please include the container number and carrier if your question is about a specific container.