Documentation Index
Fetch the complete documentation index at: https://docs.tread.ai/llms.txt
Use this file to discover all available pages before exploring further.
When to use this page
Send this link to a driver or foreman before opening a support ticket. Most issues resolve in under two minutes. If a fix below does not work, contact your Admin with the driver’s phone number and the time of the issue.Common issues
Verification code didn't arrive
Verification code didn't arrive
Wait 60 seconds before requesting a new code. SMS deliverability varies by carrier — codes from some networks arrive in under 5 seconds, others take up to a minute.If still no code after 60 seconds:
- Check the phone has signal (one bar is enough).
- Tap Resend code.
- Confirm the phone number on file matches the SIM in the phone. A driver who swapped phones but kept the number is fine; a driver on a new number needs the Admin to update the Driver record.
My boss said I got a dispatch but I don't see it
My boss said I got a dispatch but I don't see it
Almost always a stale cache or a vendor-assignment mismatch.Try in order:
- Pull-to-refresh the home screen. Drag down from the top.
- Force-quit and reopen the app.
- Check the app version under Settings → About. If older than the current store version, update.
- Confirm the vendor assignment. Ask the dispatcher which Vendor the dispatch was sent to. If it went to a Vendor the driver is no longer linked to, the dispatch will not appear. See Dispatch Modes.
iPhone — Always-Allow location prompt missing after update
iPhone — Always-Allow location prompt missing after update
iOS sometimes drops the location prompt after an OS update. The app needs Always access to log GPS in the background.Fix manually:
- Open Settings → Privacy & Security → Location Services.
- Confirm Location Services is On.
- Scroll to Tread.
- Set to Always.
- Toggle Precise Location to on.
Android — battery optimization eats GPS
Android — battery optimization eats GPS
Android battery optimization will kill background GPS without warning. The driver’s truck shows as parked even when moving.Disable optimization for Tread:
- Settings → Apps → Tread → Battery.
- Set to Unrestricted (or Don’t optimize depending on the OEM).
- On Samsung: also check Settings → Device Care → Battery → Background usage limits and remove Tread from the Sleeping apps list.
- On Xiaomi/OnePlus: enable Autostart for Tread.
App update install hangs
App update install hangs
The store download stalls at 90% or the install icon spins forever.iOS:
- Tap and hold the Tread icon → Pause Download → Resume Download.
- If still stuck: open the App Store, tap your profile, pull-to-refresh.
- Reboot the phone.
- Last resort: delete the app and reinstall.
- Settings → Apps → Google Play Store → Storage → Clear cache.
- Reopen Play Store, retry the update.
- Reboot the phone if it still fails.
Driver day stuck 'in review'
Driver day stuck 'in review'
In Review means the shift was submitted but no Ticket Approver has signed off yet. The driver can still log in and start a new day — the in-review day is locked from edits but does not block tomorrow’s work.What the driver should do:
- Nothing. The Approver clears the queue from the web app.
- Open Approvals → Driver Days, review hours and tickets, approve or reject. See Timesheet Approvals.
Offline mode — what syncs when
Offline mode — what syncs when
The Driver app keeps working when the phone loses signal. Some data uploads as soon as signal returns; some has known edge cases.Syncs immediately on reconnect:
- GPS pings (queued and uploaded in order)
- Load tickets and photos
- Status changes (en route, arrived, departed)
- Hours start/stop
- Live dispatch updates push to the phone over the network. A new dispatch sent while offline will not appear until the phone reconnects.