---
title: "Customer portal - Truck position on the portal: What, why & how."
description: "Truck position on the customer portal shows portal users a live pin for the vehicle carrying their order. A switch on each customer record turns it on."
url: https://help.qargo.com/us/articles/895134-customer-portal-truck-position-on-the-portal-what-why-how
locale: us
updated: 2026-11-10
---

# Customer portal - Truck position on the portal: What, why & how.

## Summary {#h_9da74b9747}

**What is truck position on the customer portal?**

-   A pin on the map in the customer portal order view, showing the vehicle that is currently carrying that order.
-   The pin is off by default and is controlled by one switch on each customer record.

**Why was it introduced?**

-   Portal users could already see the route and the stops, but not the truck, so they called planners to ask where a load was.
-   Qargo already links each position ping to the orders on that vehicle, but portal users had no way to read it.
-   Tenants disagree on whether a position should be shared at all, so the decision is made per customer rather than once for the whole tenant.

**How does it work?**

-   A Super Admin enables Show truck location on customer portal on the customer record.
-   On a shared load the truck can be at another customer’s stop while their order is on board.

## Prerequisites {#h_d88cd081f2}

-   Portal access must already be enabled for the customer. See [Giving access to Customer Portal](https://help.qargo.com/us/articles/133781-giving-access-to-customer-portal).
-   The **Show truck location on customer portal** switch must be enabled on the customer record. It is off by default.

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

-   A telematics or FMS integration must be supplying live positions for the vehicle. The switch remains available when no integration is connected, but there is then no position to display.

## Use Cases {#h_13d568bb91}

-   A parcel and pallet operator whose sub-depots all use the portal stops calling the hub for load positions during the day.
-   A shipper running time-critical, live-event deliveries checks the vehicle position out of hours instead of raising an after-hours ETA call.
-   A freight forwarder is given position visibility only while its own goods are in transit, so nothing is revealed about the rest of the vehicle's day.
-   A tenant enables the switch for a selected group of customers and leaves it off for every other customer.

## Terminology {#h_5f3b549773}

| Term | Definition |
| --- | --- |
| _Customer portal_ | The self-service web interface where a transport company's customers submit and track their own orders. |
| _Order view_ | The page in the customer portal showing a single order, including the map with the route and the stops. |
| _Position ping_ | A single GPS position received from a telematics or FMS integration and linked by Qargo to the orders on that vehicle. |
| _Transit window_ | The period during which a customer's own goods are on the vehicle, from departure toward their first stop until their last stop is done. |
| _Leg_ | One movement within an order. A multi-leg or part-load order has several, and only some of them may carry a given customer's goods. |

## What the customer sees {#h_444cdfcc54}

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

### Map and pin {#h_c318acf3da}

The map itself always shows on the portal order view, with or without this feature. Only the pin and _Last update_ are new.

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

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

| Condition | Portal shows |
| --- | --- |
| The switch is off | Nothing at all: no section, no message and no grayed-out control, so one customer never learns that another receives positions. |
| The switch is on, before the vehicle sets off toward the first stop | No pin, and No active tracking status is shown. |
| The switch is on, the goods are on board, a position is available | The pin with the _Last update_ with the date and time of the last position, however old that position is. |
| The switch is on, after the last stop is done | After the last stop the pin stays on the last position. It doesn’t disappear. |

:::callout{tone="note"}
-   Without a telematics or FMS integration supplying live positions, there is nothing to show on the portal.
-   Only the latest position is shown. There is no historical route trail, so the feature cannot be used to confirm that a driver stayed on an authorized route or made no unscheduled stops.
:::

## How the visibility window works {#h_abccb2ade9}

The pin is tied to the customer's own goods, not to the vehicle's day.

-   It appears when the vehicle sets off toward that customer's first stop.
-   Before the truck sets off, and when there’s no position at all, the map says “No active tracking”.

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


-   On a shared load the truck can be at another customer’s stop while their order is on board.

:::callout{tone="info"}
Position age is not hidden. The pin stays visible however old the position is, with its age shown as Last update: XX ago label on the map rather than the exact date and time, and there is no staleness cutoff to configure.
:::

:::callout{tone="note"}
🧰 **There is no option to share the position all day.** It is not something a tenant can switch on or off. The position is limited to the window in which that customer's order is on the vehicle, so they never see where the truck goes for the rest of the day. Inside that window a co-loaded load can still show the truck at another customer's stop.
:::

## Turning it on {#h_16efbacf22}

The switch Show truck location on customer portal sits in the Contacts section of the customer record, under _Companies > Customers_, beside the portal access and portal charges switches already there. It behaves the same way as Show charges on customer portal: it affects only that customer's portal users, and there is no tenant-wide equivalent.

For enabling many customers at once, the same field is available in the Update details bulk action on the Customers list.

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

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

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

The click-by-click route to the Contacts section and to the Update details bulk action is covered in [Giving access to Customer Portal](https://help.qargo.com/us/articles/133781-giving-access-to-customer-portal).

* * *

## Troubleshooting {#h_a62e8bb25b}

| **Issue** | **Resolution** |
| --- | --- |
| The customer reports seeing no map section at all | Confirm that Show truck location on customer portal is enabled on that customer record. |
| The pin shows on some legs of an order but not others | Expected. The pin appears only on the legs carrying that customer's goods. |
| The position looks out of date | The pin always shows the last position received, however old. |
| One customer can see positions and another cannot | Check the switch on each customer record, or set it for several customers at once with the Update details bulk action. |


## Related articles

- [Video - How to show the live truck position on the customer portal?](https://help.qargo.com/us/articles/894091-video-how-to-show-the-live-truck-position-on-the-customer-portal.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)
- [Customer portal: creating and planning orders shown in customer portal views](https://help.qargo.com/us/articles/316497-customer-portal-creating-and-planning-orders-shown-in-customer-portal-views.md)
- [Qargo mobile app — Location tracking for QR/PIN driver sessions — What, why & how](https://help.qargo.com/us/articles/776145-qargo-mobile-app-location-tracking-for-qr-pin-driver-sessions-what-why-how.md)
- [Planning — Stop arrival and departure events — What, why & how.](https://help.qargo.com/us/articles/838853-planning-stop-arrival-and-departure-events-what-why-how.md)
