Troubleshooting
Having issues with the RouteBot mobile app? Find solutions to common problems here.
Login Issues
Can't log in - SMS code not arriving
Possible causes:
- Incorrect phone number entered
- SMS delivery delay
- Phone has no signal
- Country not supported
Solutions:
- Verify you entered the correct phone number
- Check you selected the correct country code
- Wait 2-3 minutes for SMS delay
- Check if spam filters are blocking messages
- Ensure your phone has cellular signal
- Request a new code after timer expires
"Service not available in your country"
Cause: The selected country isn't currently supported.
Solution: Contact your transportation provider to verify your registration details and supported regions.
Login code expired
Cause: The 120-second timer ran out.
Solution: Go back and request a new code. Enter the code promptly when it arrives.
Wrong phone number entered
Solution: Tap "Wrong phone number?" on the code entry screen to go back and correct it.
Service and Route Issues
No services showing in the app
Possible causes:
- Not yet assigned to a route
- Registration issue
- Data sync delay
Solutions:
- Pull down to refresh the list
- Wait - you may not be assigned yet
- Contact your transportation provider
- Verify your phone number is registered correctly
Route status stuck on "Inactive"
Cause: The driver hasn't started the route yet.
Solution: Wait for the driver to begin the service. Tracking begins when they start.
Can't find my child's route
Solutions:
- Verify correct phone number is registered
- Check if you're logged into the correct account
- Contact your school's transportation department
- Your child may be assigned to a different parent's phone
Map and Tracking Issues
Bus not showing on map
Possible causes:
- Service isn't active
- Driver hasn't started the route
- GPS signal issues
- Data loading
Solutions:
- Check if service status is "Active"
- Wait for driver to start the route
- Pull down to refresh
- Close and reopen the service
Map not loading / blank map
Possible causes:
- No internet connection
- Slow connection
- App issue
Solutions:
- Check your internet connection
- Wait for map tiles to load
- Switch between WiFi and cellular
- Close and reopen the app
- Restart your device
Location seems stuck / not moving
Possible causes:
- GPS signal temporarily lost
- Driver in area with poor signal (tunnel, garage)
- Data delay
Solutions:
- Check the location time indicator
- Wait a moment for updates
- Pull down to refresh
- Location will update when signal returns
Location seems wrong / jumpy
Cause: GPS accuracy issues due to buildings, weather, or signal reflections.
Solution: This is usually temporary. Wait for more accurate readings. The overall route progress should still be visible.
Notification Issues
Not receiving any notifications
Possible causes:
- Notification permission not granted
- Notifications disabled in settings
- "Do Not Disturb" is on
- App notifications silenced
Solutions:
- Check notification permission: Settings > Apps > RouteBot > Notifications
- Verify notification types are enabled in app settings
- Disable "Do Not Disturb" mode
- Check RouteBot isn't silenced in notification settings
- Verify internet connection
Notifications arriving late
Possible causes:
- Network delay
- Device in power-saving mode
- Background app restrictions
Solutions:
- Ensure good internet connection
- Disable battery optimization for RouteBot (Android)
- Keep app active in foreground when expecting notifications
Receiving notifications for wrong times
Cause: Notification distance may be misconfigured.
Solution: Adjust notification distance in Settings > Notification Distance Settings.
Driver-Specific Issues
Can't start the route
Possible causes:
- Route already started/completed today
- Outside allowed time window
- Missing permissions
- Technical issue
Solutions:
- Check if route was already started today
- Verify you're within allowed operating hours
- Grant all required permissions
- Restart the app and try again
- Contact administrator if persistent
Location not tracking (drivers)
Possible causes:
- Location permission not set to "Always"
- Battery optimization killing the app
- GPS disabled
- Route not actually active
Solutions:
- Set location permission to "Always" / "Allow all the time"
- Disable battery optimization for RouteBot
- Enable GPS on your device
- Verify route status is active
Background tracking stopping
Possible causes:
- Battery optimization enabled
- App force-closed
- Permissions revoked
- Device issue
Solutions (Android):
- Disable battery optimization: Settings > Apps > RouteBot > Battery > Unrestricted
- Don't force-close the app during routes
- Check location permission is "Allow all the time"
- Keep phone charged
Solutions (iOS):
- Set location to "Always" in Settings
- Keep the app running (don't close it)
- Disable Low Power Mode during routes
QR code scanner not working
Possible causes:
- Camera permission not granted
- Camera in use by another app
- Poor lighting
- Damaged QR code
Solutions:
- Grant camera permission in device settings
- Close other camera apps
- Ensure good lighting
- Clean camera lens
- Report damaged QR codes to administrator
"Route can only be started once per day"
Cause: You already started this route today.
Solution: Routes are designed for single daily use. If you need to restart, contact your administrator.
App Performance Issues
App is slow or laggy
Solutions:
- Close other apps to free memory
- Restart the RouteBot app
- Restart your device
- Check for app updates
- Clear app cache (Android: Settings > Apps > RouteBot > Storage > Clear Cache)
App crashes
Solutions:
- Restart the app
- Restart your device
- Check for app updates
- Reinstall the app
- Report persistent crashes to support
App using too much battery
Notes:
- Location tracking uses battery (especially for drivers)
- This is expected during active routes
Solutions:
- Use a car charger during routes
- Lower screen brightness
- Close unnecessary apps
- When not driving routes, battery use should be minimal
Permission Issues
Permission prompts not appearing
Solutions:
- Go directly to device Settings > Apps > RouteBot > Permissions
- Manually grant required permissions
- Reinstall the app to trigger fresh permission prompts
Denied permission by mistake
Solutions (iOS):
- Go to Settings > RouteBot
- Tap the permission you need to change
- Select the correct option
Solutions (Android):
- Go to Settings > Apps > RouteBot > Permissions
- Tap the permission type
- Select "Allow" or "Allow all the time"
Connection Issues
"No internet connection" errors
Solutions:
- Check WiFi or cellular data is enabled
- Check airplane mode is off
- Try switching between WiFi and cellular
- Check if other apps can access internet
- Restart your device
Data not syncing
Solutions:
- Check internet connection
- Pull down to refresh
- Close and reopen the app
- Wait a moment for sync
Getting Additional Help
If these solutions don't resolve your issue:
Gather This Information
- Your phone model and OS version
- App version (if visible)
- What you were trying to do
- What happened (or didn't happen)
- Any error messages
- Screenshots if possible
Contact Support
- In-App: Settings > Support (if available)
- Help Screen: Settings > Help for contact info
- Email: Note error details before sending
- Phone: Call during business hours for urgent issues
For Route/Assignment Issues
Contact your transportation provider directly (school transportation office or company HR) for:
- Route assignment changes
- Schedule questions
- Driver issues
- Stop location updates
Related Pages:
- FAQ - Common questions answered
- Support Request - Send a support message
- First-Time Setup - Permission setup