"GPS Tracking isn't switched on for this workspace yet"
Rare, and only appears if PortaPro has hit the emergency kill switch for your organization (typically during an incident affecting our provider bill). Contact support.
"GPS Tracking requires the Growth plan"
Your organization's subscription is on a lower tier. Upgrade the subscription to make the feature available.
The consent banner won't go away
Consent must be acknowledged by an office role (Admin or Dispatcher). If you clicked but nothing changed, refresh the page, the click may have failed silently on a slow network. If it still doesn't clear, contact support with a screenshot of the browser console.
Flespi connect is stuck on a step
Click Resume setup on the Flespi row. The provisioning is designed to pick up wherever it stopped without redoing completed steps. If the same step keeps failing, the error dialog will name it, attach that message to a support request.
Samsara says "Token rejected"
Your Samsara token was rotated, revoked, or lacks the correct scope. Log into Samsara → Settings → API Tokens, create a new token with read access to Vehicles, then click Reconnect on the Samsara row and paste it.
A device shows Offline but the driver says it's fine
In order of likelihood: a cellular dead zone (the tracker is running but can't get signal; once it moves back into coverage, buffered positions burst-upload and the status recovers), low battery (check the percentage in Device Health, below 20% is a common cause), physical damage (a tag torn off a unit or a wire-in tracker unplugged during service will go silent and never recover on its own), or a wrong expected interval (a device set to 30-second pings that actually only reports hourly will look offline within an hour; edit the device's cadence to match reality).
A vehicle pin is drifting when I zoom
This was a pre-July-2026 rendering bug. If you still see it, hard-refresh the page (Cmd+Shift+R / Ctrl+Shift+F5). If it persists, screenshot and contact support.
The map shows no vehicles even though I have hardware connected
Check in order: is the layer toggle on (Jobs & Dispatch → Map → Live → Vehicles)? Does the tracker have a position yet (Device Health should show last seen under an hour ago)? Is the tracker assigned to an active vehicle (unassigned devices don't appear on the map, pins are per-asset, not per-device)? Is the tracker healthy (offline trackers gray out; stale ones amber)?
A tracked unit doesn't show on the map layer
Same order as above but check Device Health for an asset tag device type. Also confirm the Tracked Units layer (U shortcut) is on, not the Vehicles layer.
The trail line on the Vehicle Location tab is empty
The pin comes from the tracker's last-known position; the trail comes from separate historical rows. Right after a device is registered or after a long silence, the pin can be current while the 24h trail is empty. New positions fill it in as they arrive. If the trail stays empty for hours despite fresh positions, the position history endpoint may not be returning data, contact support.
I disconnected Samsara but the vehicles are still on the map
Refresh the page. Disabled Samsara devices should disappear from the map layer immediately after disconnect. If they persist, they may have been also registered as Flespi devices, check the Provider column in Device Health.
The battery percentage looks wrong
Not all trackers report battery. When the field is empty, PortaPro shows a dash rather than guessing. Digital Matter tags always report; some wired vehicle trackers don't because they're powered by the vehicle.
Contacting Support
Include the organization name, the device id or vehicle plate involved, a screenshot of the Device Health row, and any error message text (not just its screenshot).