---
title: "Shipment tracking: what, why, and how"
description: "Share a unique, time-limited tracking URL per shipment with recipients, with no portal account required. Includes a live map, freight details, and configurable fields."
url: https://help.qargo.com/us/articles/634109-shipment-tracking-what-why-and-how
locale: us
updated: 2026-04-17
---

# Shipment tracking: what, why, and how

🎥 Watch a video overview of this new feature.

::embed{src="https://watchclueso.com/embed/mp2iwk6dhv5bzrrf"}

## Summary {#h_e957470c8e}

**What is the tracking link feature?**

-   Each shipment automatically gets its own tracking page. This is a shareable URL that anyone can open without a Qargo account or login.
-   Recipients such as receivers, warehouse contacts, or one-off delivery addresses get full delivery visibility as soon as they click the link.
-   The page shows all the key information: shipment status, stop locations, estimated timestamps, freight details, pallet scan history, and a live map with the driver's position when en route.

**Why use tracking links?**

-   Receivers and delivery contacts want to know where their shipment is, but asking them to create a Qargo account isn't realistic. Tracking links give them a direct view of their delivery without an account.
-   Fewer "where is my delivery?" calls and emails mean less time spent chasing updates.
-   Tracking links work for any recipient: regular customers, one-off delivery contacts, third-party warehouses, and more.

**How does it work?**

-   A _Super Admin_ configures a _tracking link template_ to define which information fields appear on the page.
-   When a shipment is created, a tracking link is generated automatically.
-   The link is distributed to recipients through the _tasks_ system (shipment tasks or stop tasks), using the **Shipment > Tracking link** variable in email templates.
-   Links remain active for 30 days after the last shipment update and can be revoked manually at any time.

* * *

## Terminology {#h_aba09014cb}

| **Term** | **Definition** |
| --- | --- |
| _Tracking link_ | A unique, time-limited URL that gives a recipient read-only access to a shipment's tracking page, without requiring a Qargo login. |
| _Tracking page_ | The public-facing web page a recipient sees when opening a tracking link. It displays the status, locations, freight details, and a live map. |
| _Tracking link template_ | A configuration set by a Super Admin that determines which information sections and fields are shown on the tracking page. It applies to the whole tenant. |
| _Contact task_ | An automated email or notification that can be sent to a contact at a defined shipment status. Here, it is used to deliver the tracking link to the recipient. |
| _Revoke_ | Manually deactivating a tracking link so it can no longer be accessed. This is done from the shipment detail view. |

* * *

## Use cases {#h_04966669fd}

Tracking links fit naturally into a wide range of transportation workflows. Here are some common scenarios where teams use them.

### Standard receiver notification {#h_7b75e030ba}

The most common use is to automatically email receivers their tracking link when a shipment is planned or picked up. The receiver gets a live view of the delivery without a Qargo account and without any manual effort from the dispatcher.

### 3PL and multi-party shipments {#h_e1e65bf969}

In 3PL setups, transportation is sometimes arranged for one party but invoiced to another. An example is picking up from a seller and delivering to a fulfillment center. Here, the tracking link lets the seller follow the shipment in real time, without access to the full Qargo portal. Each party sees only what it needs.

### Sharing ETAs with delivery locations {#h_5f1d45cb9c}

Warehouses, ferry terminals, and other fixed delivery points often need to know when a vehicle is arriving. Sending a tracking link to the location contact lets them monitor the ETA directly instead of calling the dispatcher. This reduces inbound calls and keeps handovers smooth.

### Replacing track and trace from a previous TMS {#h_8912cd8b6d}

For teams migrating to Qargo, tracking links restore the shipment visibility that customers and receivers had in their previous system. Contacts who were used to receiving tracking updates don't need to change their workflow. They simply receive a link instead.

* * *

## What recipients see {#h_0f12878186}

Opening a tracking link takes recipients straight to a clean delivery overview, with no login and no friction. The page includes:

-   **Shipment status**: the current operations status of the shipment (e.g., **Planned**, **In transit**, **Delivered**).
-   **Stop details**: pickup and delivery locations with references, and estimated arrival timestamps.
-   **Freight details**: freight description, quantities, packaging types, and pallet scan history.
-   **Map**: shows the pickup and delivery locations on a map. When the driver is actively en route to the delivery stop, the map also shows the driver's live position.

![](https://help.qargo.com/media/aa7782e7346b-Screenshot-2026-04-13-at-14_12_14.png)

Additional information sections (such as customer reference, container no., transportation service, custom fields, and extra fields) can be made visible by configuring the _tracking link template_. See **Configuring the tracking link template** below.\
The tracking page is fully responsive and works in both desktop and mobile browsers.

:::callout{tone="note"}
📚 Tracking pages are available in English only and don't support custom branding. Each tracking link covers a single shipment. If an order has multiple shipments, each one gets its own separate link.
:::

* * *

## Setup and configuration {#h_e5eec5abef}

### Prerequisites {#h_1a9904ad82}

Setting up tracking links takes three steps: **one for a Qargo Admin** and two for a Super Admin.

1.  **Qargo Admin:** Enable the **Tracking link** integration for the tenant.
2.  **Super Admin:** Configure a _tracking link template_ to define what information appears on the page.
3.  **Super Admin:** Set up _contact tasks_ (shipment or stop level) to send the tracking link to recipients by email.

* * *

### Step 1: Enabling the tracking link integration (Qargo Admin) {#h_8d35185827}

The **Tracking link** integration needs to be activated on the tenant before anything else is possible.\
Once it is active, tracking links are generated automatically for every new shipment. Nothing further is needed at this stage.

:::callout{tone="info"}
**💬 Contact** the Qargo team to have the **Tracking link** integration added and enabled.
:::

* * *

### Step 2: Configuring the tracking link template (Super Admin) {#h_ab8485b3ff}

The _tracking link template_ determines what recipients actually see on their tracking page. One template covers all tracking pages across the tenant, so it's worth taking the time to configure it carefully.

1.  **Navigate** to **Configuration > Templates > Integration templates**.
2.  **Select** the **Tracking link** template type.
3.  **(Optional) Configure** any additional fields to add to the default template format.\
    Available options include:

    -   Shipment status
    -   Stop references
    -   Estimated timestamps
    -   Freight details and pallet scan history
    -   Customer reference
    -   Container no.
    -   Transportation service
    -   Custom fields
    -   Extra fields

    ![](https://help.qargo.com/media/766f43d40d6c-image.png)

4.  **Save** the template configuration.

:::callout{tone="note"}
🧰 The template applies to the whole tenant: all recipients see the same layout and field selection. Templates per customer or per transportation service are currently not available.
:::

* * *

### Step 3: Sending tracking links through tasks (Super Admin) {#h_6cd8bb5262}

The tracking link reaches recipients through the _tasks_ system. Add the `tracking link` variable to any **_shipment task or stop task email template,_** and Qargo handles the rest. Each recipient automatically gets their own unique link.

1.  **Navigate** to **Configuration > Tasks**.
2.  **Select** or create a **Contact task** at the shipment level.
3.  **In the email body**, type `#{{` or click the variable button in the editor, search for **Shipment > Tracking link**, and select it from the list. Qargo replaces this with each recipient's unique tracking link when the task is sent.

    ![](https://help.qargo.com/media/118ac565f96d-Screenshot-2B2026-04-13-2Bat-2B13_46_16.png)

4.  **Configure** the recipient, typically the delivery contact or location contact linked to the stop.
5.  **Save** the task configuration.

:::callout{tone="info"}
🧰 Tracking tasks need to be configured at the **shipment level (**Create shipment** and **Shipment: To plan**), on order tasks.**
:::

![](https://help.qargo.com/media/989c0926e2e2-image.png)

-   When the task is triggered, the recipient automatically receives an email containing their personalized tracking link.

![](https://help.qargo.com/media/74e7b04ce92a-Screenshot-2026-04-14-at-10_01_17.png)

:::callout{tone="note"}
📚 Tracking links are only generated for shipments created after the integration is set up. To generate tracking links for existing shipments, use **Recalculate tasks** on the order list page.
:::

![](https://help.qargo.com/media/d2058769da63-Screenshot-2026-04-14-at-09_47_03.png)

* * *

## Managing tracking links {#h_dac74880f1}

### Link expiration {#h_af7e61a8ba}

Tracking links stay active for **30 days after the last update** to the shipment and then expire automatically. Recipients who try to open an expired link see a clear expiration message.

### Revoking a link {#h_67ba1f789d}

If a link needs to be deactivated early (for example, if it was sent to the wrong contact), it can be revoked at any time from the shipment detail view.

1.  **Navigate** to the order and scroll to the shipment section.
2.  **Locate** the sharing icon.

    ![](https://help.qargo.com/media/4d6519b42e67-Screenshot-2026-04-14-at-09_31_16.png)

3.  **Select** **Revoke and generate a new link**.

    ![](https://help.qargo.com/media/78a1b78291dd-Screenshot-2026-04-13-at-14_24_32.png)


Once revoked, the link is deactivated immediately. The recipient sees an error or expiration message when trying to access the page.

:::callout{tone="warning"}
‼️ Revocation is permanent: the link cannot be reactivated. A new link is not generated automatically; it must be generated manually by following the same steps.
:::

* * *

## Troubleshooting {#h_c38404cf00}

| **Issue** | **Likely cause** | **Resolution** |
| --- | --- | --- |
| No tracking link is generated for new shipments | The **Tracking link** integration is not enabled on the tenant | Contact a Qargo Admin to enable the integration |
| The tracking link variable is not available in the task template editor | The integration is not enabled for the tenant, or the task is not created at the shipment or stop level. | Check whether the task is created at the shipment or stop level. If the issue persists, contact a Qargo Admin |
| The recipient's link shows an error or "expired" message | The link has been revoked manually, or 30 days have passed since the last shipment update | Revocation cannot be undone. Check the shipment activity and inform the recipient accordingly |
| The driver's live position is not showing on the map | The driver is not yet en route to the delivery stop, or location sharing is not active on the driver's device | The live position only appears once the driver is actively en route to the delivery |
| The tracking link covers only one shipment, but the order has several | Expected behavior: each shipment generates its own unique tracking link | Send the relevant shipment-level link to each recipient, or configure tasks at the stop level for more targeted delivery |


## Related articles

- [Customer portal walkthrough](https://help.qargo.com/us/articles/133782-customer-portal-walkthrough.md)
- [Tasks: add workflow tasks](https://help.qargo.com/us/articles/133819-tasks-add-workflow-tasks.md)
- [New order field for contact emails](https://help.qargo.com/us/articles/217700-new-order-field-for-contact-emails.md)
- [PN - Pallet Track integration: What, why & how.](https://help.qargo.com/us/articles/879827-pn-pallet-track-integration-what-why-how.md)
- [Planning – ETA calculations in Qargo: what, why, and how](https://help.qargo.com/us/articles/664264-planning-eta-calculations-in-qargo-what-why-and-how.md)
