> ## Documentation Index
> Fetch the complete documentation index at: https://support.fieldko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fix Sync Errors

> Find out what a sync message means and fix records and photos that won't upload from the FieldKo Atlas app.

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](/getting-started/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.

<Warning>
  **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](/troubleshooting/send-data-to-support) first. You can't discard a single failed record, so fix it or contact support.
</Warning>

### Errors You Can Fix in the Record

| Message | What to Do |
| - | - |
| Required fields are missing | Salesforce requires a field that's empty. Tap the record name, fill in the fields listed under **Fields:**, and then tap **Retry Item**. |
| Validation rule failed | The record breaks a Salesforce validation rule. Open the record and correct it. If it isn't clear what's wrong, ask your admin. |
| Text is too long | A text value is longer than Salesforce allows. Shorten the text and retry. |
| Duplicate value already exists | A unique field matches another record. Change the value and retry. |

### Errors That Clear When You Try Again

| Message | What to Do |
| - | - |
| Record is locked by another process, try again | Salesforce was busy with the record. Wait a few minutes, and then tap **Retry Item**. |
| Server error, try again later | Salesforce had a temporary problem. Try again later. |
| No parent record found, update the records and sync again. | A related record you created offline hasn't uploaded yet. Sync again. If it keeps happening, [send your data to support](/troubleshooting/send-data-to-support). |

### Errors Your Admin or Manager Must Fix

| Message | What to Do |
| - | - |
| You don't have permission to save this | Your profile can't create or edit that record or field. Ask your admin to check your access. |
| Invalid field value | A field isn't accessible or has changed in Salesforce. Ask your admin to check the field. Then [reset sync](/sync/reset-sync), after you read the earlier warning. |
| Sorry! No Call Cycle available. Please Contact your Manager or Administrator | The visit's date isn't inside one of your active call cycles. Ask your manager to set up your call cycle, or move the visit. |

### Other Errors

| Message | What to Do |
| - | - |
| Not found on server, may have been deleted | The record was deleted in Salesforce. No fix is needed. The change can't upload. |
| Missing required information to sync | Your device is missing setup data for that object. [Reset sync](/sync/reset-sync), after you read the earlier warning. |
| Invalid data format / Unable to save changes | Something else went wrong. Tap **Show Details**, and then [contact support](/troubleshooting/send-data-to-support). |

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**.

| Message | What to Do |
| - | - |
| Sync is set to WiFi only. Connect to WiFi to sync. | Connect to Wi-Fi, or in **Settings**, turn off **WiFi Only**. |
| Couldn't verify your session. Check your connection and tap Retry. | You're probably offline. Reconnect and try again. |
| Sign in is required to sync. | Log in again with the **same** account. A different account can delete your unsynced data. See [Asked to Log In Again](/troubleshooting/sign-in-and-setup#asked-to-log-in-again). |
| Background sync is in progress. Please wait for it to complete. | Wait a moment, and then tap **Sync** again. |
| Another sync is already running. Please wait for it to finish. | Wait for the current sync to finish. |
| Failed to sync local changes. Continuing with data download... | Your uploads failed, but downloads continued. Check **Sync History**. |
| Sync aborted: no progress on repeated batch | A record keeps failing and stops the sync. Don't log out or reset sync. [Send your data to FieldKo support](/troubleshooting/send-data-to-support). |
| Insufficient Privilege: User does not have access to FieldKo | Your user isn't set up for FieldKo. Ask your admin to assign you the FieldKo Representative Permission Set. |
| No profile metadata found. Please contact to you administrator to generate it. | Ask your admin to run the Metadata Collector for your profile. |

## Fix Photos That Aren't Uploading

Check each of these in order:

<AccordionGroup>
  <Accordion title="Is Sync Images Turned On?">
    On the **Sync** screen, turn on **Sync Images**, and then tap **Sync**. Background sync never uploads photos.
  </Accordion>

  <Accordion title="Has the Record Synced?">
    A photo uploads only after its record is in Salesforce. First, fix any record errors in **Sync History**.
  </Accordion>

  <Accordion title="Is Your Connection Fast Enough?">
    Large photos upload slowly on weak signals. Sync on Wi-Fi, or for future photos, lower **Max Photo Size** in [Settings](/getting-started/settings#photos).
  </Accordion>

  <Accordion title="Is Total Images Stuck Above 0?">
    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](/troubleshooting/send-data-to-support).
  </Accordion>
</AccordionGroup>

## 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](/sync/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](/sync/how-sync-works#when-the-same-record-changes-in-two-places).

## See Also

* [Troubleshooting: Start Here](/troubleshooting/start-here)
* [Sync Your Data](/sync/sync-screen)
* [Reset Your Offline Data](/sync/reset-sync)
* [Send Your Data to FieldKo Support](/troubleshooting/send-data-to-support)
* [Understand Offline Work and Sync](/sync/how-sync-works)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.