| Map shows no driver markers | No drivers have GPS enabled, or no drivers are assigned to the current branch | Verify that drivers have allowed location access in their browser. Check that drivers are assigned to the correct branch in user settings. |
| Driver marker is gray (offline) | The driver's browser has not sent a location update in over 15 minutes | Contact the driver. They may have closed their browser, lost connectivity, or revoked location permissions. |
| Map does not load at all | Map provider API key is missing or invalid | Go to Settings → Integrations → Maps and verify the API key. Or switch to OpenStreetMap/Leaflet which requires no key. |
| Auto-optimize returns empty results | No unassigned shipments exist, or no active drivers are available for the branch | Verify there are shipments in "pending" or "processed" status. Ensure at least one driver is active and assigned to the branch. |
| Cannot drag shipments to drivers | Browser drag-and-drop may be blocked by extensions or touch mode | Try disabling browser extensions. On touch devices, use the "Assign To" dropdown instead of drag-and-drop. |
| Manifest cannot be edited after closing | Closed manifests are locked by design to prevent accidental changes | If changes are needed, create a new manifest with the correct shipments. Only "Open" manifests can be modified. |
| Driver trails not visible | The driver has been stationary or only recently came online | Trails require at least 2 location data points over time. Wait for the driver to move, and the trail will appear within a few minutes. |
