> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.chrt.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.chrt.com/_mcp/server.

# Trackers on Orders

> How to link a tracker to a cargo item on a chrt order, view the merged map (driver plus cargo trackers), and swap or remove a tracker mid-order.

When you create a chrt order, you can attach one or more trackers to one or
more of the order's cargo items. After this flow, the tracker's location
shows up on the order's **Map** tab next to the driver's location, and
condition data (temperature, light, shock) lands in the order timeline.

## Before you start

* The order must have at least one cargo item. Trackers attach to cargo,
  not to orders or task groups.
* The tracker must be registered to your organization, or you must have
  its MAC address in hand to register it on the fly. See
  [Supported devices](/trackers/supported-devices) for what hardware chrt
  supports.

## 1. Open Add Tracker on the order

Open the order at [chrt.com/orders](https://chrt.com/orders) and click
into it. In the order header, open the actions menu and click **Add
Tracker**.

![Order page with Add Tracker open in the order header](/_fern-img/141ec2e18f97d612100506603d35a1ced10929f4e96b6cf59abbc3ebff434752.webp)

## 2. Choose register-new or use-existing

The **Add Tracker Device** dialog gives you two modes:

* **Register a new device.** Enter the **Device MAC address** (printed on
  the tracker hardware) and pick the cargo to link it to.
* **Use an existing device.** Pick a device that is already registered to
  your org and is not currently on a session or linked to active cargo.

![Add Tracker Device dialog with register and existing-device modes](/_fern-img/434d5bef89b6e44adb1c4a6c26b5adc0b38530d75b6dc62559a070b5bdb80da4.webp)

> **Tip**
>
> If your cargo combobox shows no options, the order doesn't have cargo
> yet. Add cargo to the order draft (see
> [Creating shipments](/shippers/creating-shipments)) before linking a
> tracker.

## 3. Confirm and save

Click **Register Device** (or **Confirm** for an existing device). The
tracker now appears in the cargo item's details, and the cargo row shows
its linked device.

![Cargo item details showing the linked tracker](/_fern-img/5bbda3307ed2e516ef80c4be2f1b5d06ebb040ec0868f62e74670deb2c8f09a1.webp)

## 4. View the merged map

Open the order's **Map** tab. The map renders every active marker for
this order on the same canvas:

* The **driver's** location (from the chrt driver app), once they accept
  a task and grant location permission.
* Every **tracker linked to cargo** on the order, including any Tive
  device imported via the integration.

![Order Map tab with both a driver marker and a cargo tracker visible](/_fern-img/acb8d7992b8b827c8a7f13bad5e0863effb7ce6be9ec1ef0516ce7bfbd2ed650.webp)

Click the **Layers** button in the top-left to toggle the **Route** layer
(planned segments and stops) and the **Tracking** layer (live driver and
tracker pings) independently.

> **Note**
>
> At least one layer must stay enabled. If you turn off **Route**, the map
> shows only the live tracking. If you turn off **Tracking**, you see the
> planned path with no live markers.

## 5. Swap or remove a tracker mid-order

To **swap** a tracker (for example, because a Tive battery died):

1. Register the replacement device if it's new — see
   [Standalone trackers](/trackers/standalone#1-devices-table-and-register-device).
2. On the order, open **Add Tracker** again and link the replacement to
   the same cargo item.
3. The old device's history stays on the cargo's timeline; the new
   device picks up from the next ping cycle.

To **remove** a tracker without replacing it, open the cargo item's
detail panel and unlink the device. The device returns to your idle pool
on [Devices](https://chrt.com/tracking/devices) and is available for
the next session or order.

> **Warning**
>
> Unlinking a tracker from cargo does not delete its session history. If
> you've shared the session publicly, the public URL keeps showing the
> recorded path until you terminate or delete the session.

## How to know it worked

* The linked device appears in the cargo item's detail panel within
  seconds.
* The first ping from a newly registered tracker can take **up to about
  15 minutes** to appear on the order's Map tab.
* Condition events (low battery, temperature excursion, shock) land in
  the order timeline once telemetry arrives.

## If something looks different

* **Add Tracker is disabled.** The order has no cargo yet. Add cargo
  first.
* **Tracker doesn't appear on the Map tab.** Confirm the **Tracking**
  layer is enabled in the Layers popover, and wait up to 15 minutes
  for the first ping.
* **You see a Tive device that isn't on your linked Tive account.**
  Confirm the integration is enabled — see
  [Integrations](/trackers/integrations) — and that the device shows up
  under
  [Integrations > Devices](https://chrt.com/tracking/integrations/devices).
* Contact [trackers@chrt.com](mailto:trackers@chrt.com) for hardware
  questions or [hi@chrt.com](mailto:hi@chrt.com) for everything else.

## Related guides

* [Supported devices](/trackers/supported-devices) — the device matrix.
* [Standalone trackers](/trackers/standalone) — track without an order.
* [Battery and data](/trackers/battery-data) — swap a dead Tive mid-shipment.
* [Integrations](/trackers/integrations) — link Tive shipments to orders.
* [Tracking concepts](/docs/concepts/tracking) — how chrt models devices
  and pings.
* [Orders concept](/docs/concepts/orders) — orders, task groups, and
  cargo.