Skip to main content
When a sync doesn’t finish cleanly, the FieldKo Atlas app lists each problem in Sync History so you can fix it. Most errors clear after you correct the record or reconnect, and then sync again. New to sync? See Key Concepts.

​
Find Out What Failed

Start on the Sync screen, where the app keeps a record of your recent syncs:
  1. In the side menu, tap Sync.
  2. Under SYNC HISTORY, tap the latest entry marked PARTIAL or FAILED.
  3. Under ISSUES, review each issue. Each one shows the record, the object, and a short message.
  4. Optional: To see the technical error, the fields involved, and the record IDs, tap Show Details.

​
Fix Record Errors

Find your message in the following tables. In most cases, fix the record and then sync again.
Some fixes in these tables use Reset Sync, which can delete the change that failed. If a reset shows Unsynced local changes, tapping Proceed permanently deletes those changes. To keep them, tap Cancel, and send your data to FieldKo support first. You can’t discard a single failed record, so fix it or contact support.

​
Errors You Can Fix in the Record

​
Errors That Clear When You Try Again

​
Errors Your Admin or Manager Must Fix

​
Other Errors

Each sync retries a failing record up to 3 times. Records with permission or validation problems don’t succeed until someone fixes the data or access. When you ask your admin for help, tell them the record, object, and fields shown under Show Details.

​
Sync Screen Messages

These messages appear on the Sync screen itself, not in Sync History.

​
Fix Photos That Aren’t Uploading

Check each of these in order:
On the Sync screen, turn on Sync Images, and then tap Sync. Background sync never uploads photos.
A photo uploads only after its record is in Salesforce. First, fix any record errors in Sync History.
Large photos upload slowly on weak signals. Sync on Wi-Fi, or for future photos, lower Max Photo Size in Settings.
A photo that fails 5 times stops retrying but stays in the count. Don’t reset sync yet, because a reset removes stuck photos. First, send your data to FieldKo support.

​
Fix Data That Looks Out of Date

  • Pull-down refresh: Pulling down on the home screen doesn’t sync. On the Sync screen, tap Sync.
  • Layout, field, and object changes: These arrive only when you reset sync.
  • Missing visits: Check with your manager that you have an active call cycle. Without one, no visits sync.
  • Missing records: The record might not be assigned to you. You receive accounts you own or are on the account team for. Ask your admin.
  • Edits that don’t reach Salesforce: An edit can sync without an error but not reach Salesforce if you don’t have permission to edit that field. Ask your admin.
  • Your change was replaced: If someone changed the same record in Salesforce after you edited it, the app might keep their newer change. See When the Same Record Changes in Two Places.

​
See Also

Last modified on October 20, 2026