If SharePoint files need to appear in File Explorer or Finder, you now have two buttons that look as though they do the same job: Sync and Add shortcut to OneDrive.
They are not quite the same.
Microsoft recommends OneDrive shortcuts as the more versatile option. A shortcut belongs to the user's OneDrive and follows that user across devices. A conventional SharePoint sync is configured on one device.
That does not make Sync obsolete, and it does not make shortcuts exempt from OneDrive's normal sync limits. Both routes use the OneDrive sync app when the files appear on a computer.
The short answer
Use Add shortcut to OneDrive for most people who need a particular SharePoint or Teams folder in their everyday files.
Use Sync when you deliberately need a device-specific library connection—for example, where IT is deploying a library through policy or you have an established managed-device design that depends on conventional library sync.
Do not use both methods against the same SharePoint document library. Microsoft says that combination is blocked by design.
| Decision | Add shortcut to OneDrive | Sync |
|---|---|---|
| Where it is configured | In the user's OneDrive | On a particular device |
| Where it appears | OneDrive on the web, File Explorer, Finder, Teams and OneDrive mobile apps | File Explorer or Finder on the configured device |
| Scope | A whole library or a selected folder | The document library |
| Across devices | The shortcut follows the user | The user configures each device |
| Offline files | Available through the OneDrive app; files must be downloaded or pinned for offline use | Available through the OneDrive app; files must be downloaded or pinned for offline use |
| Admin deployment | Normally added by the user | Libraries can be configured on managed devices with OneDrive policies |
| External users | Microsoft says shortcuts are available only to internal users | Assess the guest scenario separately; do not assume a shortcut will work |
| Microsoft's current recommendation | Recommended as the more versatile option | Still supported, but not the default recommendation |
What the two buttons actually do
Add shortcut to OneDrive
The shortcut adds a SharePoint or Teams library—or one folder within it—to My files in the user's OneDrive.
It is not a copy of the content and it does not move ownership into the user's personal storage. The source remains in SharePoint, with the same permissions. The shortcut is simply a user-specific route to that source.
Microsoft's shortcut instructions say the result appears in:
- OneDrive on the web
- Windows File Explorer
- macOS Finder
- Microsoft Teams
- the OneDrive mobile apps
That account-level behaviour is the strongest reason to prefer a shortcut. A user adds it once instead of visiting the library and starting a separate sync on every computer.
The user can also add just the folder they need. This matters in a large library: less irrelevant content is presented to the sync app and to the person trying to find their work.
Sync
The Sync button asks the OneDrive app on that computer to connect to the SharePoint document library. The library then appears in File Explorer or Finder under the organisation's SharePoint location.
Changes work both ways. A rename, move, edit or deletion in the local synced location is a change to the SharePoint content, not a private local operation. Microsoft describes this behaviour in its SharePoint and OneDrive sync overview.
Sync is device-specific. If a user changes laptop, they normally need the connection on the new device too—unless IT provisions it through policy.
This is why Sync still has a place. The OneDrive administrative templates include a policy to configure team-site libraries to sync automatically. That can be useful on tightly managed Windows devices, provided the library and item count are suitable.
The important limit shortcuts do not remove
The old version of this article claimed shortcuts could comfortably handle 500,000 items while Sync failed at 300,000. Microsoft does not support that comparison.
Microsoft's current OneDrive restrictions and limitations recommend syncing no more than 300,000 items in total across a user's cloud storage for optimum performance. Problems can occur above that number even when not every item is kept offline.
That total can include the user's own OneDrive content, SharePoint libraries and shortcut content visible to the sync app. A shortcut is a better route to a focused folder; it is not a separate high-volume sync engine.
Microsoft is publicly previewing support for up to one million items per sync instance on qualifying Windows devices, but the preview has specific hardware, operating-system and OneDrive Insider requirements. Do not design a broad production rollout around a preview without testing your own managed-device estate.
Also check the 400-character decoded path limit and other file restrictions. Neither button repairs an over-deep information architecture.
A decision you can defend
Choose Add shortcut to OneDrive when:
- the person needs one working folder rather than a whole library
- the same files should be easy to find across several signed-in devices
- you want the route Microsoft currently recommends
- users are comfortable adding and removing their own shortcuts
- the people are internal members of your organisation
Choose Sync when:
- IT must provision a suitable library on managed devices
- an existing managed-device design is already based on library sync
- the work is deliberately tied to a particular device configuration
- your guest-access requirement has been tested and shortcuts are unavailable
- you have a clear reason to expose the whole library rather than one working folder
Do not choose either method as a substitute for good library design. If hundreds of thousands of items sit under one route, divide the content according to ownership and work—not simply to make the sync client stop complaining.
How to add a SharePoint or Teams shortcut
- Open the document library in SharePoint. For Teams channel files, open the channel's Files area and choose Open in SharePoint if you need the library view.
- To add the whole library, choose Add shortcut to OneDrive from the command bar. To add only one folder, select that folder first.
- Open OneDrive on the web and check My files. The new folder should display a shortcut icon.
- Check File Explorer or Finder on a device signed into the same work account.
- Open a test file, make a harmless change and confirm that the change appears in SharePoint.
Microsoft permits up to 100 shortcuts from the same document library. The command is unavailable for individual files, multiple selected folders, or a folder that has already been added.
Make selected content available offline
Both methods use Files On-Demand. A cloud icon means the item is visible but not currently stored on the device.
For a folder that must work without a connection, use the OneDrive context menu and select Always keep on this device. Then wait for the download to finish and test while disconnected. Do not assume that seeing a filename proves the file is available offline.
How to move from Sync to a shortcut safely
Do not simply delete the old folder and hope the cloud copy is complete.
- Check the OneDrive status and resolve any reported sync errors.
- Open the SharePoint library in a browser and confirm that recent files and changes are present.
- In OneDrive settings, open Account, find the SharePoint library and choose Stop sync. Microsoft's stop-sync guidance explains the device step.
- Keep the former local folder temporarily if it contains anything you have not verified online. Stopping sync does not upload a file that was already stuck.
- Add the required library or folder with Add shortcut to OneDrive.
- Confirm the shortcut in OneDrive on the web and on the device.
- Test create, edit, rename and offline behaviour with non-production files.
- Remove the old local folder only after the SharePoint copy and the new route have been checked.
For a large rollout, pilot the change with a representative group first. Record which libraries are conventionally synced, which folders will become shortcuts, the expected item count and the rollback owner.
How to remove a shortcut without deleting shared content
This is the part to explain carefully to users.
The safe, unambiguous route is:
- Open OneDrive on the web.
- Go to My files.
- Select the shortcut folder.
- Choose Remove shortcut.
Microsoft states that Remove shortcut removes the route from the user's OneDrive and devices without affecting the source folder or other people.
Do not open the shortcut and delete its contents. Those are real SharePoint files. A deletion inside the folder can delete the shared item for everyone who uses the source, subject to permissions and recycle-bin recovery.
Fix “You're already syncing a shortcut to a folder from this shared library”
This message means OneDrive has detected both access methods against the same library.
Decide which method you want, then remove the other:
- To keep the shortcut, stop the conventional library sync in OneDrive settings.
- To keep Sync, remove the shortcut from OneDrive on the web > My files > Remove shortcut, wait for OneDrive to update, then start the library sync.
Microsoft's troubleshooting article confirms that the restriction is by design. Do not try to beat it by renaming the local folder or relinking the OneDrive account repeatedly.
If the shortcut appears online but not on the computer
Check these in order:
- The OneDrive app is running.
- The app is signed into the same work or school account used to create the shortcut.
- The shortcut appears in OneDrive on the web > My files.
- Choose folders in OneDrive settings is not excluding it.
- The total item count, file names and paths remain within Microsoft's documented limits.
- The user still has permission to the source folder.
If the web shortcut is correct but the device remains stuck, use Microsoft's OneDrive sync troubleshooting before unlinking the whole account. An account reset creates a much larger recovery job than fixing one excluded or conflicting folder.
What administrators should do
Publish one standard, not two vague options
Tell users which button your organisation prefers, when the exception applies and how to remove a shortcut safely. If both commands are left unexplained, people will inevitably try both.
Hide Sync only after the migration is understood
A SharePoint administrator can run:
Set-SPOTenant -HideSyncButtonOnTeamSite $true
Microsoft says this prevents new SharePoint library syncs from being started but does not remove existing syncs. Hiding the button is therefore a user-interface policy, not a migration.
Monitor the client, not just the library
Enable OneDrive sync health reports for managed devices. They can show device sync status, client versions and health issues. A SharePoint library looking fine in the browser does not prove that every laptop is current.
Test the real permissions boundary
A shortcut does not grant access. If someone loses permission to the source, the shortcut does not preserve it. Equally, moving a shortcut inside a shared OneDrive folder does not grant other people access to the shortcut's target.
Frequently asked questions
Does Microsoft recommend shortcuts instead of Sync?
Yes. Microsoft's current guidance recommends OneDrive shortcuts as the more versatile option because they follow the user across devices and can target the required folder. Sync remains supported.
Can I use Sync and Add shortcut to OneDrive for the same library?
No. Microsoft blocks that combination by design. Stop the library sync or remove the shortcut before switching methods.
Do shortcuts bypass the 300,000-item recommendation?
No. Shortcut content still reaches the computer through the OneDrive sync app. Microsoft's current optimum-performance recommendation is no more than 300,000 synced items across the user's cloud storage.
Can external guests add SharePoint shortcuts to their OneDrive?
Microsoft's support page says the shortcut procedure is available only to internal users. Test the exact guest scenario and provide browser access or another governed route where the shortcut is unavailable.
Does Remove shortcut delete the SharePoint folder?
No. Remove shortcut removes the user's route to the folder. Deleting files or folders inside the shortcut is different and can change the shared SharePoint source.
The sensible default
For ordinary internal collaboration, start with a shortcut to the smallest useful folder. It follows Microsoft's recommendation, travels with the user and avoids exposing an entire library when the person needs one working area.
Keep Sync for an explicit, documented device-management or access requirement. Whichever route you choose, count the items, test offline behaviour, monitor sync health and make the delete-versus-remove distinction impossible to miss.
If you run SharePoint and Teams in the real world—where permissions, sync errors and sprawling libraries refuse to stay tidy—join the SharePoint & Teams Admins Space. It is built for practical fixes and current Microsoft 365 decisions, not recycled product folklore.
How this article was checked
This rewrite was fact-checked on 13 August 2026 against current Microsoft Learn and Microsoft Support documentation for recommended sync configuration, Sync versus shortcuts, shortcut behaviour, the same-library conflict and OneDrive restrictions.