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

# Sync Your Data

> Use the Sync screen to upload your changes, check what's pending, and review your sync history.

The Sync screen is where you send your work to Salesforce and get the latest updates. It also shows what's waiting to upload and how your recent syncs went. To learn how sync works, see [Understand Offline Work and Sync](/sync/how-sync-works).

To open the Sync screen, in the side menu, tap **Sync**. Or, on the home screen, tap **+**, and then tap **Sync Data**.

## Run a Sync

A sync uploads your changes and downloads the latest updates from Salesforce. With **Sync Images** on, it also uploads your photos. If the button says **Background Syncing...**, a background sync is already running. Wait for it to finish, and then start these steps.

<Steps>
  <Step title="Check Your Connection">
    Under **SYNC STATUS**, make sure **Status** says **Online**.

    * **Online** means only that your device has a connection. A weak signal can still make sync slow.
  </Step>

  <Step title="Turn On Sync Images If You Have Photos">
    Turn on **Sync Images** so photos and signatures upload. When it's off and photos are waiting, the screen shows how many won't upload.
  </Step>

  <Step title="Tap Sync">
    While the sync runs, don't leave the Sync screen or switch apps.

    * A progress bar shows the percentage and the time remaining.
    * The menu and Back button are disabled until the sync finishes.
  </Step>

  <Step title="Check the Result">
    If you see "Sync completed successfully", you're done. If you see "Sync error: …", open the latest entry in [Sync History](#sync-history) to see what failed, and then follow [Fix Sync Errors](/troubleshooting/sync-errors).
  </Step>
</Steps>

## Recommended Sync Routine

Sync several times a day. Your work reaches Salesforce sooner, and you get your manager's latest changes. If your company uses background sync, it uploads your records, but not your photos.

| When to Sync | Why |
| - | - |
| Start of the day | Get visits and changes added since your last sync |
| After each visit, when you have a good connection | Upload your work and photos early |
| End of the day | Make sure nothing is left on your device |

Each time, turn on **Sync Images**, and then tap **Sync**. At the end of the day, check that **Total Records** and **Total Images** are both **0**. For the full end-of-day steps, see [Finish Your Day](/getting-started/first-day#finish-your-day).

Keep these points in mind:

* **Use Reset Sync only when you need it.** Use it when a normal sync fails or your data looks wrong. See [Reset Your Offline Data](/sync/reset-sync).
* **Don't log out to end your day.** Logging out deletes work that hasn't synced. Stay logged in. See [Log Out Safely](/sync/logging-out).
* **Optional: Sync only on Wi-Fi.** In **Settings**, turn on **WiFi Only**. The **Sync** button and background sync then run only on Wi-Fi. Off Wi-Fi, you see "Sync is set to WiFi only. Connect to WiFi to sync." The setting turns off when the app restarts. See [Sync Settings](/getting-started/settings#sync-settings).

## Read the Sync Screen

### Sync Status

**Data** and **Images** show when each last synced. Each shows **PENDING** if something is waiting, or **COMPLETED** if not.

### Pending Changes

| Row | What It Means |
| - | - |
| **Total Records** | Records you've created, updated, or deleted that haven't uploaded |
| **Total Images** | Photos, signatures, and files waiting to upload, including ones that failed |
| **Details** | The breakdown, for example "3 created, 1 updated, 0 deleted" |
| **Sync Data Size** | Roughly how much data the next sync uploads |

<Warning>
  **Logging out or switching users deletes any work that hasn't synced.** Before you log out, reinstall the app, or hand your device to someone else, make sure **Total Records** and **Total Images** are both **0**. See [Log Out Safely](/sync/logging-out).
</Warning>

### Background Sync Errors

If background sync had problems, you see **N background error(s)**. Tap **Show details** to see which records failed and why. These records retry automatically at your next sync. **Clear** only hides the list. It doesn't fix or remove the records.

### Sync History

**SYNC HISTORY** lists your last 10 syncs. Each entry shows how many records went to and from Salesforce, and a status of **SUCCESS**, **PARTIAL**, or **FAILED**.

Tap an entry to see its details. Problems are listed under **ISSUES**, and you can act on each one in these ways:

* Tap the record name to open and fix the record.
* Tap **Retry Item** to run another sync.
* Tap **Show Details** to see the technical error. FieldKo support might ask for this.

To learn what each message means, see [Fix Sync Errors](/troubleshooting/sync-errors).

To refresh the Sync screen, pull down on it.

## Other Tools on the Sync Screen

| Tool | What It Does |
| - | - |
| **Reset Sync** | Deletes and downloads your offline data again. If you tap **Proceed**, changes that can't upload are permanently deleted. Read [Reset Your Offline Data](/sync/reset-sync) first. |
| **Data Recovery** | Sends a copy of your app data to FieldKo support. See [Send Your Data to FieldKo Support](/troubleshooting/send-data-to-support). |

## See Also

* [Understand Offline Work and Sync](/sync/how-sync-works)
* [Fix Sync Errors](/troubleshooting/sync-errors)
* [Reset Your Offline Data](/sync/reset-sync)
* [Log Out Safely](/sync/logging-out)


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