SharePoint sync is in beta. Speckle turns it on for each workspace that takes part, and it runs on
Speckle’s hosted service only.
What Speckle can read
- Every SharePoint site, read-only. The approval lets Speckle’s app read every SharePoint site in your organization. Speckle downloads only the files that members pick for a sync. That limit is how Speckle behaves, not a limit Microsoft enforces. You cannot narrow the approval to chosen sites today.
- Members browse as themselves. To pick files, each member signs in with their own Microsoft 365 work account. They see only the sites and files they can open in SharePoint.
- Background checks run as Speckle’s app. Every 5 minutes, Speckle reads each synced file to check for a new published version, and downloads it when one exists.
- Nothing is written. Speckle never changes, uploads, or deletes anything in SharePoint.
Who can approve
Approval needs a Privileged Role Administrator or a Global Administrator in Microsoft Entra. The approval includes an application permission for Microsoft Graph, so an Application Administrator or a Cloud Application Administrator cannot complete it.Approve Speckle
1
Open the approval link
Sign in to Microsoft as an admin who can approve. Then open Approve Speckle for your
organization.
Microsoft’s approval screen opens.
2
Check that the screen is Speckle's
Check that the application ID on the screen matches Speckle’s application ID, shown below these
steps. Speckle’s publisher is verified, so the app also carries Microsoft’s verified publisher
badge.
3
Review the permissions
The screen lists the permissions in the table above. Read items in all site collections
(
Sites.Read.All) appears twice. One entry is for members who sign in, and the other is for
Speckle’s app.4
Accept
Select Accept. You land on a page that confirms the approval.
Approved
Speckle is approved for your organization. Members can now sign in with their Microsoft account on a Speckle project and sync files from SharePoint. Point them to Sync models from SharePoint. You need no Speckle account, and there is nothing else to set up.Approval not completed
Speckle was not approved, and nothing changed in your organization. This happens when you select Cancel, or when your account cannot approve apps for the organization. Check who can approve, then open the approval link again.Remove Speckle’s access
1
Find Speckle in Entra
In the Microsoft Entra admin center, go to Enterprise
applications and search for Speckle’s application ID. Speckle’s app appears in the results.
2
Delete the app
Open the app, go to Properties, and select Delete. The app no longer appears under
Enterprise applications.
FAQ
Do members need an admin role to sync files?
Do members need an admin role to sync files?
No. After you approve Speckle, any member with access to a file in SharePoint can sync it from a
Speckle project where they can create syncs.
A member says Speckle is not approved yet. What do I check?
A member says Speckle is not approved yet. What do I check?
Search Enterprise applications in the Microsoft Entra admin center for Speckle’s application
ID. If the app does not appear, approve Speckle again. If it does, ask the member to select
Sign out on the SharePoint page and connect again.
What happens to synced models if we remove Speckle?
What happens to synced models if we remove Speckle?
Syncs pause and stop creating versions. Models and versions already in Speckle stay, under
Speckle’s project roles, until a project owner removes them.