Skip to content

Sync is stuck or failing

The Pending uploads badge on the mobile app won't clear, or the web portal shows stale data.

On mobile

Try first

  1. Pull to refresh on the Dashboard.
  2. Open Settings → Force sync.
  3. Confirm the Wi-Fi or mobile signal is stable. A weak signal makes background uploads fail silently.
  4. Toggle airplane mode off then on.
  5. Restart the app.

If a specific task won't upload

  1. Open the task from Tasks → Drafts.
  2. Check for validation errors (red asterisks).
  3. If the task looks complete, the server may have rejected it — check with your Supervisor to see if the task was deleted or reassigned.

Photos won't upload

See Photo upload is failing.

"Please update the app to continue" prompt during sync

Occasionally — usually after a platform release — sync will pause with a prompt asking you to update the app. This happens when the server has rolled out a schema change that the older app version can't render correctly (a new task-type field, a restructured response format).

What to do:

  1. Don't factory-reset — your drafts and pending uploads are safe.
  2. Open the App Store / Play Store.
  3. Install the update for Smart Maintenance Task Manager.
  4. Reopen the app.
  5. Sync resumes automatically; queued items upload normally.

If the prompt keeps appearing after updating, force-quit the app and reopen — app-store cached metadata can lag a few minutes.

Still stuck

  • Re-pair the app. Settings → Factory reset → Confirm. This clears the local cache; you lose any drafts that haven't synced. Contact your Supervisor first if that's a concern.
  • Contact support.

On the web portal

Try first

  1. Refresh the page (Cmd / Ctrl + R).
  2. Check the network indicator in the header — a red dot means the WebSocket connection dropped.
  3. Sign out and sign back in.

"Can't connect to realtime"

This is the real-time connection. Reasons it fails:

  • Corporate firewall blocking WebSocket upgrades.
  • Ad blockers or privacy extensions interfering.
  • Temporary server-side issue.

The portal keeps working without the WebSocket, but live updates won't arrive until you refresh.