Skip to content

Commit 958d01e

Browse files
authored
Update common-sync-issues.md
1 parent 39b9fa1 commit 958d01e

1 file changed

Lines changed: 44 additions & 50 deletions

File tree

Lines changed: 44 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
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
@@ -16,119 +16,113 @@ ms.custom:
1616
- CI 157491
1717
- CSSTroubleshoot
1818
ms.reviewer: prbalusu; nirupme
19-
description: Provides resolutions for some common issues with syncing SharePoint lists offline.
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 Windows task manager and look for “__Microsoft OneDrive Sync Service__ (__OneDrive.Sync.Service.exe__)” under **Processes** > **Background Processes**.
30+
1. Open Windows Task Manager, and locate the following process under **Background Processes**:
31+
32+
__Microsoft OneDrive Sync Service__ (__OneDrive.Sync.Service.exe__)
3233

3334
- If __Microsoft OneDrive Sync Service__  is running, continue to step 2.
34-
- If __Microsoft OneDrive Sync Service__ isn't running, List sync isn't running. Your organization might have prevented it from syncing, see [Lists sync policies](/sharepoint/lists-sync-policies).
35+
- If __Microsoft OneDrive Sync Service__ isn't running, the List sync process isn't running. Your organization might have prevented it from running. For more information, see [Lists sync policies](/sharepoint/lists-sync-policies).
3536

3637
1. <a href=#logging>Enable Web App Logging</a>.
37-
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.
3839

39-
:::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":::
4041

41-
- 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.
42-
- 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", 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).
4344

44-
1. If __OneDrive.Sync.Service.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>.
4546

4647
</details>
47-
<br/>
4848
<details>
4949
<summary><b>Sync icon stays on for more than 10 minutes</b></summary>
5050

51-
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.
5252

53-
:::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.":::
5454

55-
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.
56-
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 will stay 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>.
5757

5858
</details>
59-
<br/>
6059
<details>
6160
<summary><b>Local changes not synced</b></summary>
6261

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

65-
:::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.":::
6665

67-
1. If there are conflicts, refresh the page and try the update again.
68-
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>.
6968

7069
</details>
7170
<div id="support"></div>
7271

7372
## Contacting support
74-
<br/>
7573
<details>
76-
<summary><b>Information needed to open a Microsoft support request</b></summary>
77-
78-
- **Required** The email address used to log into the List web app.
79-
- **Required** A general time stamp of when the issue occurred (within a few hours is usually enough).
80-
- **Required** A description of the issue.
81-
- **Required** Browser type (Edge, Chrome, etc).
82-
- **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.
83-
- **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.
84-
- **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 usually sufficient).
78+
- **Required:** A description of the issue.
79+
- **Required:** Web browser that's used (Edge, Chrome, and so on).
80+
- **Optional:** Screenshots of the issue. The more detail that's included in the request, the more likely that the Microsoft team will be able to quickly respond.
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+
8584
</details>
86-
<br/>
8785
<div id="logging"></div>
8886
<details>
8987
<summary><b>Enable web app logging</b></summary>
9088

91-
1. Open the browser and navigate to the list in question.
92-
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 you use Microsoft Edge, Google Chrome, or Mozilla FireFox. These are the only currently supported browsers. Also, make sure you're on a device that's running Windows 10 or a later version.
9391
1. Press F12 to open the browser tools.
9492
1. Switch to the **Application** tab.
95-
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`.
9694

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

99-
:::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.":::
10098

101-
1. With the browser tools still open, switch to the **Console** tab and press F5 to refresh the page.
102-
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.
103100
</details>
104-
<br/>
101+
<div id="collect"></div>
105102
<details>
106103
<summary><b>Collect Microsoft SharePoint client logs</b></summary>
107104

108-
1. Open File Explorer.
105+
1. Open File Explorer.
109106
1. Navigate to `%localappdata%\Microsoft\OneDrive\logs\ListSync`.
110-
1. Right-click the “Business1” folder and then select **Send To** > **Compressed (zipped) folder**.
111-
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.
112109

113110
</details>
114-
<br/>
115111
<details>
116112
<summary><b>Create a support request</b></summary>
117113

118-
Microsoft 365 admin users have access to create support requests.
119-
120-
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:
121115

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

124-
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.
125119

126120
Select **Contact Support**.
127121

128122
</details>
129123

130124
## References
131125

132-
- [Edit lists offline](https://support.microsoft.com/office/41403c3e-1795-4e07-b56b-ae591cbde2f9)
126+
[Edit lists offline](https://support.microsoft.com/office/41403c3e-1795-4e07-b56b-ae591cbde2f9)
133127

134-
- [Lists sync policies](/sharepoint/lists-sync-policies)
128+
[Lists sync policies](/sharepoint/lists-sync-policies)

0 commit comments

Comments
 (0)