Field Service Mobile App: Service Appointments Not Syncing Due to Unfiltered List View

Summary: Service appointments may fail to sync in the Field Service Mobile App when the default list view returns a high-volume dataset. Filtering the list view by date range (±7–15 days) and assigned technician resolves the sync performance issue.

Scope: This article addresses service appointment sync failures caused by unfiltered or overly broad default list views in the Field Service Mobile App. It does NOT cover sync failures due to orphaned records, missing field-level security, validation rule conflicts, or duplicate list view API names — see related articles for those scenarios.

Description

Service appointments may not sync to the Field Service Mobile App when the default list view is configured to return a large dataset without filtering. This causes performance degradation and incomplete synchronization of appointment records to the mobile client.

Symptoms

- Service appointments do not appear in the Field Service Mobile App, or only a partial list appears.
- The sync process takes an unusually long time or times out.
- The mobile app displays a sync error or hangs during the data refresh.
- The issue persists even after restarting the app or re-logging in.

Cause

The Field Service Mobile App syncs appointment data from the default Service Appointment list view. When this list view has no filters or overly broad filters, it returns a high-volume dataset. The mobile app must process and store all records locally, which can exceed device memory or network bandwidth constraints, resulting in incomplete or failed sync operations.

Resolution

Modify the default Service Appointment list view to filter by date range and assigned resource:

1. In Setup, navigate to Object Manager and select Service Appointment.
2. Under List Views, select the default list view used by the Field Service Mobile App.
3. Click Edit.
4. Add a filter for the Scheduled Start date: set the range to ±7–15 days from today (e.g., "Scheduled Start is in the last 7 days" OR "Scheduled Start is in the next 15 days").
5. Add a second filter for the Assigned Resource field: set it to the current user or a specific technician role.
6. Click Save.
7. Verify the list view now displays a manageable number of appointments (typically under 500 records).
8. On the mobile device, force a full sync: open the Field Service Mobile App, navigate to Settings, and select Sync Now or Clear Cache and Sync.

After these changes, service appointments should sync completely to the mobile app.

Known Limitations

- The Field Service Mobile App syncs only the records visible in the default list view. If the assigned technician changes or the date range shifts, the app may not automatically refresh the list view — a manual sync may be required.
- Filtering by date range alone (without resource assignment) may still return a large dataset if many appointments are scheduled within the range. Combine both filters for optimal performance.
- Custom list views are not supported by the Field Service Mobile App; only the default list view is synced.

Add Description section explaining the symptom

## Description

Service appointments may not sync to the Field Service Mobile App when the default list view is configured to return a large dataset without filtering. This causes performance degradation and incomplete synchronization of appointment records to the mobile client.

Add Cause section explaining list view performance impact

## Cause

The Field Service Mobile App syncs appointment data from the default Service Appointment list view. When this list view has no filters or overly broad filters, it returns a high-volume dataset. The mobile app must process and store all records locally, which can exceed device memory or network bandwidth constraints, resulting in incomplete or failed sync operations.

Add Resolution section with step-by-step list view filtering

## Resolution

Modify the default Service Appointment list view to filter by date range and assigned resource:

1. In Setup, navigate to Object Manager and select Service Appointment.
2. Under List Views, select the default list view used by the Field Service Mobile App.
3. Click Edit.
4. Add a filter for the Scheduled Start date: set the range to ±7–15 days from today (e.g., "Scheduled Start is in the last 7 days" OR "Scheduled Start is in the next 15 days").
5. Add a second filter for the Assigned Resource field: set it to the current user or a specific technician role.
6. Click Save.
7. Verify the list view now displays a manageable number of appointments (typically under 500 records).
8. On the mobile device, force a full sync: open the Field Service Mobile App, navigate to Settings, and select Sync Now or Clear Cache and Sync.

After these changes, service appointments should sync completely to the mobile app.

Add Known Limitations section

## Known Limitations

- The Field Service Mobile App syncs only the records visible in the default list view. If the assigned technician changes or the date range shifts, the app may not automatically refresh the list view — a manual sync may be required.
- Filtering by date range alone (without resource assignment) may still return a large dataset if many appointments are scheduled within the range. Combine both filters for optimal performance.
- Custom list views are not supported by the Field Service Mobile App; only the default list view is synced.

Add Additional Resources section with cross-links

## Additional Resources

- Unable to Complete Data Sync in Salesforce Field Service Mobile App [ka0Hx000002sbz7IAA] — troubleshoot alternative sync-failure causes (orphaned records, field-level security).
- Send Salesforce Field Service Mobile App Device Logs [ka0Hx000002vctpIAA] — capture device logs for further diagnosis if sync issues persist.
- Duplicate List View API Names Cause Incorrect List View to Load in Salesforce [ka0Hx0000030DUzIAM] — verify list view configuration if sync persists after filtering.