Skip to content

Commit f9c7b1a

Browse files
authored
Merge pull request #9448 from NirupamaMeesala/docs-editor/common-sync-issues-1753898624
AB#7031: Update common-sync-issues.md
2 parents b3ad870 + 9850233 commit f9c7b1a

1 file changed

Lines changed: 48 additions & 55 deletions

File tree

Lines changed: 48 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Common issues syncing SharePoint lists offline
2+
title: Common Issues Syncing SharePoint Lists Offline
33
ms.author: meerak
44
author: Cloud-Writer
55
manager: dcscontentpm
6-
ms.date: 12/17/2023
6+
ms.date: 07/30/2025
77
audience: Admin
88
ms.topic: troubleshooting
99
search.appverid:
@@ -15,121 +15,114 @@ ms.custom:
1515
- sap:Lists and Libraries\Lists Offline sync
1616
- CI 157491
1717
- CSSTroubleshoot
18-
ms.reviewer: prbalusu, sharepoint_triage
19-
description: Resolutions for some common issues with syncing SharePoint lists offline.
18+
ms.reviewer: prbalusu; nirupme
19+
description: Provides resolutions for some common issues that affect syncing SharePoint lists offline.
2020
---
2121

2222
# Common issues syncing Microsoft SharePoint lists offline
2323

24-
This document contains troubleshooting steps for common issues with syncing lists offline.
24+
This article helps you troubleshoot common issues that occur when you try to sync Microsoft SharePoint lists offline.
2525

2626
## Troubleshooting
27-
<br/>
2827
<details>
2928
<summary><b>Sync icon doesn't appear</b></summary>
3029

31-
1. Open the Windows task manager and look for “Microsoft SharePoint (Microsoft.SharePoint.exe)” under **Processes** > **Background Processes**.
30+
1. Open Windows Task Manager, and locate the following process under **Background Processes**:
3231

33-
:::image type="content" source="./media/common-sync-issues/background-processes.png" alt-text="Microsoft SharePoint shows as a background process.":::
34-
35-
- If SharePoint is running, continue to step 2.
36-
- If SharePoint isn't running, List sync isn't running. Your orgnization might have prevented it from synching, see [Lists sync policies](/sharepoint/lists-sync-policies).
32+
__Microsoft OneDrive Sync Service__ (__OneDrive.Sync.Service.exe__)
3733

34+
- If __Microsoft OneDrive Sync Service__  is running, continue to step 2.
35+
- If __Microsoft OneDrive Sync Service__ isn't running, the List sync process isn't running. Your organization might be preventing it from running. For more information, see [Lists sync policies](/sharepoint/lists-sync-policies).
36+
3837
1. <a href=#logging>Enable Web App Logging</a>.
39-
1. Check the console log for a line that includes "Found list". It will look similar to this example:
38+
1. Check the console log for a line that starts with "Found list" in the text. The line should resemble the following screenshot.
4039

41-
:::image type="content" source="./media/common-sync-issues/console.png" alt-text="Console log line that starts with Found List":::
40+
:::image type="content" source="./media/common-sync-issues/console.png" alt-text="Screenshot that shows a console log line that starts with found list":::
4241

43-
- If there is no log line starting with “Found list”, it might mean the List sync process hasn't synced the list yet. Wait for silent configuration or syncing to occur.
44-
- If the line with "Found list" shows unsynced:true", the list is currently unsynced because List sync doesn’t support it. This is by design, and List sync will be extending our support for lists in future versions. See the "Current Limitations of List sync" section in [Edit lists offline](https://support.microsoft.com/office/41403c3e-1795-4e07-b56b-ae591cbde2f9).
42+
- If there's no log line that starts with “Found list,” the List sync process might not have synced the list yet. Wait for silent configuration or syncing to occur.
43+
- If the line with "Found list" shows "unsynced:true" in the text, the list is currently unsynced because List sync doesn’t support it. This is by design. We expect to extend support for lists to future versions of List sync. For more information, see the "Current Limitations of List sync" section in [Edit lists offline](https://support.microsoft.com/office/41403c3e-1795-4e07-b56b-ae591cbde2f9).
4544

46-
1. If Microsoft.SharePoint.exe is running, and there is a “Found list” log line that does not show "unsynced", it could be a client issue. See <a href=#support>Contacting Support</a>.
45+
1. If __OneDrive.Sync.Service.exe__ is running, and the log contains a "Found list" line that doesn't show "unsynced," you might be experiencing a client issue. Go to <a href=#support>Contacting Support</a>.
4746

4847
</details>
49-
<br/>
5048
<details>
5149
<summary><b>Sync icon stays on for more than 10 minutes</b></summary>
5250

53-
The sync icon will often be on for a few minutes, appearing next to the list name:
51+
The sync icon is often in the "on" state for a few minutes. It appears next to the list name, as shown in the following screenshot.
5452

55-
:::image type="content" source="./media/common-sync-issues/sync-icon.png" alt-text="The sync icon appears next to the list name.":::
53+
:::image type="content" source="./media/common-sync-issues/sync-icon.png" alt-text="Screenshot that shows the sync icon next to the list name.":::
5654

57-
If the icon stays on for more than 10 minutes, first make sure that the client device is online. If it is offline, the sync icon will stay on.
58-
If the client device is online, and the sync icon shows for more than 10 minutes, see <a href=#support>Contacting Support</a>.
55+
If the icon stays on for more than 10 minutes, make sure that the client device is online. If it's offline, the sync icon stays on.
56+
If the client device is online, and the sync icon shows for more than 10 minutes, go to <a href=#support>Contacting Support</a>.
5957

6058
</details>
61-
<br/>
6259
<details>
6360
<summary><b>Local changes not synced</b></summary>
6461

65-
1. See if there are any conflicts or failed uploads. Navigate to **View** > **All items** > **Items that need attention**.
62+
1. Check whether there are any conflicts or failed uploads. Open **View** > **All items** > **Items that need attention**.
6663

67-
:::image type="content" source="./media/common-sync-issues/conflicts.png" alt-text="Conflicts are shown in the menu.":::
64+
:::image type="content" source="./media/common-sync-issues/conflicts.png" alt-text="Screenshot that shows conflicts in the menu.":::
6865

69-
1. If there are conflicts, refresh the page and try the update again.
70-
1. If there are no conflicts, or the conflicts continue to appear after step 2, see <a href=#support>Contacting Support</a>.
66+
1. If there are conflicts, refresh the page, and then try again to run the update.
67+
1. If there are no conflicts, or the conflicts continue to appear after step 2, go to <a href=#support>Contacting Support</a>.
7168

7269
</details>
7370
<div id="support"></div>
7471

7572
## Contacting support
76-
<br/>
7773
<details>
78-
<summary><b>Information needed to open a Microsoft support request</b></summary>
79-
80-
- **Required** The email address used to log into the List web app.
81-
- **Required** A general time stamp of when the issue occurred (within a few hours is usually enough).
82-
- **Required** A description of the issue.
83-
- **Required** Browser type (Edge, Chrome, etc).
84-
- **Optional** Screenshots of the issue. The more detail in the request, the more likely Microsoft team will be able to quickly assist and won’t need to ask for more information.
85-
- **Optional** If you enabled web app logging during debugging, send a copy of the console logs. You can right-click the console in the browser tools and select “Save as” to generate a file.
86-
- **Optional** The ticket might require client logs to be collected separately. See “Collect Microsoft SharePoint client logs” below.
74+
<summary><b>Information required to open a Microsoft support request</b></summary>
75+
76+
- **Required:** The email address that's used to sign in to the List web app.
77+
- **Required:** A general time stamp of when the issue occurred (a time that's within a few hours is sufficient).
78+
- **Required:** A description of the issue.
79+
- **Required:** Web browser that you use (Edge, Chrome, Firefox).
80+
- **Optional:** Screenshots of the issue. The more detail that you include in the request, the more likely that the Microsoft team can respond quickly.
81+
- **Optional:** If you enabled web app logging during debugging, send a copy of the console logs. You can right-click the console in the browser tools, and then select "Save as" to generate a file.
82+
- **Optional:** The ticket might require client logs to be collected separately. Go to <a href=#collect>Collect Microsoft SharePoint client logs</a>.
83+
8784
</details>
88-
<br/>
8985
<div id="logging"></div>
9086
<details>
9187
<summary><b>Enable web app logging</b></summary>
9288

93-
1. Open the browser and navigate to the list in question.
94-
1. Make sure you are using Microsoft Edge, Google Chrome, or Mozilla FireFox. These are the only currently supported browsers. Also make sure you are on a device running Windows 10 or later.
89+
1. Open the browser, and navigate to the list that you're working with.
90+
1. Make sure that you use Microsoft Edge, Google Chrome, or Mozilla FireFox. These browsers are the only ones that are currently supported. Also, make sure that you're on a device that's running Windows 10 or a later version.
9591
1. Press F12 to open the browser tools.
9692
1. Switch to the **Application** tab.
97-
1. On the left side of the pane should be a list of Local Storage domains. Expand the **Local Storage** category and select the one that corresponds to the list URL. For example, if you were viewing `https://contoso.sharepoint.com/teams/teamSite/Lists/Number%20List/AllItems.aspx` you would pick `https://contoso.sharepoint.com`.
93+
1. On the left side of the pane, locate a list of local storage domains. Expand the **Local Storage** category, and select the item that corresponds to the list URL. For example, if you're viewing `https://contoso.sharepoint.com/teams/teamSite/Lists/Number%20List/AllItems.aspx`, select `https://contoso.sharepoint.com`.
9894

99-
1. Add `sharepoint.datasync.nucleus.logToConsole` in the right pane by selecting an empty line. Set the value to **true**.
95+
1. In the right pane, add `sharepoint.datasync.nucleus.logToConsole`. To do this, select an empty line, and then set the value to **true**.
10096

101-
:::image type="content" source="./media/common-sync-issues/logto.png" alt-text="sharepoint.datasync.List sync.logToConsole is added with the value set to True.":::
97+
:::image type="content" source="./media/common-sync-issues/logto.png" alt-text="Screenshot that shows that sharepoint.datasync.List sync.logToConsole is added and the value is set to true.":::
10298

103-
1. With the browser tools still open, switch to the **Console** tab and press F5 to refresh the page.
104-
1. The console will contain useful logging for web app issues.
99+
1. While the browser tools are still open, switch to the **Console** tab, and then press F5 to refresh the page. The console contains useful logging for web app issues.
105100
</details>
106-
<br/>
101+
<div id="collect"></div>
107102
<details>
108103
<summary><b>Collect Microsoft SharePoint client logs</b></summary>
109104

110-
1. Open File Explorer.
105+
1. Open File Explorer.
111106
1. Navigate to `%localappdata%\Microsoft\OneDrive\logs\ListSync`.
112-
1. Right-click the “Business1” folder and then select **Send To** > **Compressed (zipped) folder**.
113-
1. Send that zip file to Microsoft support.
107+
1. Right-click the “Business1” folder, and then select **Send To** > **Compressed (zipped) folder**.
108+
1. Send that compressed folder to Microsoft Support.
114109

115110
</details>
116-
<br/>
117111
<details>
118112
<summary><b>Create a support request</b></summary>
119113

120-
Microsoft 365 admin users have access to create support requests.
121-
122-
Select the link below, which will populate the pane in the Microsoft 365 Admin Center.
114+
Microsoft 365 administrative users have access to create support requests. Select the following link to populate the pane in the Microsoft 365 Admin Center:
123115

124116
[Run query: Issues with editing Microsoft Lists offline](https://aka.ms/editlistofflineIssue)
125117

126-
Fill in the Description field with the **Information needed to open a Microsoft support request**, above.
118+
Complete the **Description** field by using the information that you gathered in the "Information required to open a Microsoft support request" section.
127119

128120
Select **Contact Support**.
129121

130122
</details>
131123

132124
## References
133125

134-
- [Edit lists offline](https://support.microsoft.com/office/41403c3e-1795-4e07-b56b-ae591cbde2f9)
135-
- [Lists sync policies](/sharepoint/lists-sync-policies)
126+
[Edit lists offline](https://support.microsoft.com/office/41403c3e-1795-4e07-b56b-ae591cbde2f9)
127+
128+
[Lists sync policies](/sharepoint/lists-sync-policies)

0 commit comments

Comments
 (0)