Frequently asked questions

Grouped by topic. Need something else? Ask the AI.

📱 Trucker Tools App

Tracking isn't working — first thing to try?
Turn OFF any VPN on your phone. A VPN hides or fakes your phone's real location and will block tracking. Fully disable any VPN app or VPN setting, then reopen the Trucker Tools app and confirm it shows 'Tracking On.'
The broker says I'm not tracking, but I have the app — why?
Almost always one of these: a VPN is on, you didn't tap START, location isn't set to Always / Allow all the time, you didn't open the assigned load, you're still tracking a previous load, the app needs a force-close and restart, or a setting changed mid-trip. Work through the checklist in order.
My phone keeps dropping tracking / I see a red banner.
A red banner means location permission isn't set to Always (iPhone) / Allow all the time (Android). Tap the banner → Open Settings → set location to always-allow with Precise Location on. Tracking only runs while location is always-allowed.
When does tracking auto-start?
Only when all three are true: the previous load is ended (or you aren't tracking anything), you open the Trucker Tools app within 24 hours of pickup, and location is set to always-allow. A custom TMS start window can shorten the 24-hour window.
How do I download the Trucker Tools app?
Tap the link in the tracking text (sent up to 24h before pickup), install the free app from the App Store / Google Play, verify your phone with the 4-digit code, then tap START. Set location to always-allow.
How do I send the broker a document (BOL/POD)?
While tracking, tap Scan, choose the stop if asked, capture the image, pick the document type, name it, and submit. It goes straight to the broker's TMS and portal.
What are 'custom actions' the app is asking me to do?
Brokers can add required actions to a load — photos, an inspection checklist, a piece/pallet count, arrived/departed confirmation, or a signature. Open Actions on the track or stop screen and complete each.

🗺️ MacroPoint App

MacroPoint isn't tracking — first thing to try?
Turn OFF any VPN on your phone. A VPN hides or fakes your real location and blocks tracking. Disable any VPN app or setting, then reopen the MacroPoint app. Also confirm location is set to Always Allow.
How do I install the MacroPoint driver app?
Tap the texted link → Download MacroPoint App, or search 'MacroPoint for Truckers' in the App Store / Google Play. Accept the prompts, set location to Always Allow, enter your phone number, and verify with the texted PIN. It's free.
Why does MacroPoint need 'Always Allow' location? Is it tracking me all the time?
No. Always Allow does not mean constant tracking — MacroPoint only collects location during an assigned tracking session, and shares it only with your carrier. 'While Using the App' isn't enough and tracking will fail.
I never got the PIN / my PIN won't work.
Tap Resend for a new code (resending 3x within 24 hours is limited). If no text arrives at all, tap Back and re-enter your phone number, checking the country code.
What does a MacroPoint status like 'Tracking – Waiting for Update' mean?
It was tracking but new location data hasn't arrived on the expected interval — often a VPN, location turned off, or no signal. See the full status list for what each one means and what to do.
How does a carrier connect tracking to MacroPoint?
Three free options: ELD/GPS, your TMS (API or CSV), or the MacroPoint for Truckers app. Contact your Carrier Activations Consultant (or the Descartes activation team) to set it up — ServiceDesk@Descartes.com / (888) 544-3844 ext. 2.

BotLine Verification

What is BotLine — do I need to download an app?
No app needed. BotLine is a quick check-in link a broker texts you. Tap the link, enter the 3-digit code from the text, allow location for a moment, and take a photo if asked. It is usually done in under a minute.
The BotLine link won't open.
Turn off any VPN or private browser, then open the link in your normal browser (Safari or Chrome). If it still won't load, copy the link into a fresh browser tab. A VPN or private-relay setting is the usual cause.
BotLine won't take my location, or says location is off.
When the page asks for location, tap Allow. On iPhone, turn off Private Relay and set Safari location to Allow. Make sure any VPN is off — BotLine needs your real location for the check-in.
My BotLine check-in won't submit.
Allow location and camera when prompted, turn off any VPN, and confirm you entered the 3-digit code from the text. If it still won't go through, reopen the link in Safari or Chrome and try once more.
BotLine is asking for a photo — why?
Some brokers require a quick proof photo (the truck, trailer, or BOL) as part of the check-in. Allow camera access, take the photo it asks for, and submit. It confirms you are at the right place.

🛰️ Samsara

How do I connect my Samsara ELD to Trucker Tools?
Authorize the Trucker Tools integration for your Entire Organization (so all vehicles/trailers are visible), using the correct Samsara account, and give the asset value exactly as named in Samsara. The Trucker Tools ELD team completes the hookup — eldsetup@truckertools.com / 703-955-3560.
How do I share a live-location link from Samsara?
In the Samsara dashboard, open the vehicle, click Share → Live Sharing, set an expiration, and send the link. The viewer sees live location with no Samsara login until it expires.
A truck isn't showing after connecting Samsara — why?
Usually the integration wasn't authorized for the Entire Organization, the wrong Samsara account was connected, or trailer permissions are off. See 'Missing assets' or contact eldsetup@truckertools.com.

📍 Motive

How do I connect my Motive ELD to Trucker Tools?
Add the Trucker Tools integration from your Motive account's app marketplace, using the correct Motive account, and provide the asset value as named in Motive. If trailer devices are missing, remove and re-add Trucker Tools in the marketplace to enable trailer permissions. ELD team: eldsetup@truckertools.com / 703-955-3560.
How do I share a live-location link from Motive?
In the Motive Fleet Dashboard, open the vehicle, choose Share Live Location, set a duration, and send the link. No Motive login is needed to view it.
Trailers aren't showing after connecting Motive — why?
Your integration likely predates Motive's trailer support. Remove Trucker Tools in the Motive marketplace and re-add it to enable trailer permissions, or contact eldsetup@truckertools.com.

🔌 ELD / Telematics Connection

Why isn't my telematics (ELD) load tracking?
Common causes: the load has no asset (truck/trailer) ID set, the asset ID doesn't match the carrier's telematics formatting, or the provider doesn't expose an asset list. See 'Telematics error statuses' and 'Missing assets'.
It says 'asset is not set' on the load.
The load track has no truck/trailer number. Add one from your TMS or manually in the Load Track portal, formatted as in the carrier's asset list. Tracking starts 15–20 minutes after it's added.
The truck or trailer isn't in the asset list — why?
Common causes: the provider doesn't expose assets (Omnitracs, Big Road, etc.), the value isn't formatted like the carrier's telematics account, not all providers are integrated, the truck is ELD-exempt, or trailer permissions are missing. See 'Missing assets'.
I'm a carrier — how do I change the truck on a load?
Either open the Load Track email link and click Modify ELD, or log in to the Carrier Portal → My Loads → 3-dots → Edit Driver Details.