Installation Guide
SPExplorer is a single SPExplorer.aspx file that you upload to your SharePoint site. It runs entirely inside your SharePoint environment — no external services, no data leaves your tenant. Setup takes about 5 minutes.
Requirements
SharePoint Environment
SharePoint Online (Microsoft 365), SharePoint Server 2019, or SharePoint 2016.
Browser
Google Chrome, Microsoft Edge, Mozilla Firefox, or Apple Safari.
Permissions
A SharePoint Administrator (to enable custom scripts — one-time) and a user with "Add and Customize Pages" permission (to upload the file).
Part 1: Enable Custom Scripts
This is a one-time setting that allows SharePoint to run the SPExplorer page. It must be done by a SharePoint Administrator or Global Administrator.
This step must be completed first
If custom scripts are not enabled, uploading the file will fail or the page will show an error. The setting can take up to 24 hours to take effect, so it is best to do this step first.
Method 1: SharePoint Admin Center (recommended)
This is the easiest method. No technical knowledge required.
- Open your browser and go to the Microsoft 365 Admin Center:
https://admin.microsoft.com - In the left sidebar, scroll down and click Admin centers, then click SharePoint. This opens the SharePoint Admin Center.
Or go directly to:
https://YOUR-TENANT-admin.sharepoint.com(replace YOUR-TENANT with your organisation's name, e.g.contoso-admin.sharepoint.com) - In the SharePoint Admin Center, click Sites in the left sidebar, then click Active sites.
- Find the site where you want to install SPExplorer. Click on the site name to select it.
- A panel will open on the right. Click the Settings tab.
- Scroll down to the Custom script section. You will see two options:
- • Prevent users from running custom script (this is the default)
- • Allow users to run custom script
Select "Allow users to run custom script".
- Click Save.
- Wait up to 24 hours for the change to take effect. In many cases it is faster (sometimes within minutes), but Microsoft does not guarantee an exact time.
Method 2: PowerShell (faster, for IT administrators)
This is faster but requires PowerShell. Use this if you are comfortable with the command line.
- Open PowerShell on your computer (search for "PowerShell" in the Start menu).
- If you have not installed the SharePoint module before, run this command first:
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
- Connect to your SharePoint admin site. Replace
yourtenantwith your organisation's name:Connect-SPOService -Url https://yourtenant-admin.sharepoint.com
You will be prompted to sign in. Use your admin account.
- Enable custom scripts on your site. Replace the URL with your actual site:
Set-SPOSite -Identity https://yourtenant.sharepoint.com/sites/YourSite -DenyAddAndCustomizePages 0
- Wait a few minutes, then proceed to Part 2. The PowerShell method is usually faster than the Admin Center.
Part 2: Upload SPExplorer
Once custom scripts are enabled, uploading SPExplorer takes less than 2 minutes.
Go to your SharePoint site
Open your browser and go to the site where you want SPExplorer — for example: https://yourtenant.sharepoint.com/sites/YourSite
Open the SiteAssets library
Click the gear icon (⚙️) in the top right corner, then click Site contents. Find and open the SiteAssets library.
If you don't see SiteAssets, you can also use the Documents library or create a new library. SiteAssets is recommended because it is less visible to end users.
Upload the file
Click Upload in the toolbar (or Upload → Files), then select the SPExplorer.aspx file from your computer.
Open SPExplorer
Important: Do not click the file name inside the library — this will download the file instead of opening it.
Instead, type the URL directly in your browser address bar:
https://yourtenant.sharepoint.com/sites/YourSite/SiteAssets/SPExplorer.aspx
Replace yourtenant and YourSite with your actual SharePoint URL.
Done!
SPExplorer will automatically detect your SharePoint site, find your document libraries, and configure itself. Bookmark this URL so you can get back to it easily.
How to Know It's Working
When SPExplorer loads successfully, you should see:
- Your company name and branding in the header bar.
- Folder tiles on the Home page showing your document library.
- The Explorer view with a folder tree on the left and files on the right.
- You can click into folders and see your SharePoint files.
Troubleshooting
Problem"Sorry, something went wrong" or the page won't load
Fix: Custom scripts are not enabled on the site. Go back to Part 1 and follow the steps. Remember that the change can take up to 24 hours to take effect.
ProblemThe file downloads instead of opening
Fix: You clicked the file name inside the library. Instead, type the full URL directly into your browser address bar: https://yourtenant.sharepoint.com/sites/YourSite/SiteAssets/SPExplorer.aspx
ProblemBlank page with no content
Fix: Try a different browser (Chrome or Edge work best). Check that ad blockers or browser extensions are not blocking scripts on the SharePoint domain.
ProblemMissing folders or empty library
Fix: Check that you have at least Read access to the document library. Try refreshing the page.
ProblemI don't have admin access to enable custom scripts
Fix: Ask your IT team to enable custom scripts on the site — it is a one-time change. Forward them the instructions in Part 1 above. They can do it from the SharePoint Admin Center in a few clicks.
Updating SPExplorer
To update to a newer version, simply replace the file:
- Download the latest
SPExplorer.aspxfile from your purchase page. - Go to the same SiteAssets library where the current file is stored.
- Upload the new file and choose Replace when prompted.
- Refresh the page — you are now running the latest version.
Your data is safe
Your favourites, recent files, and settings are stored in your browser. Replacing the file does not affect any of this data.
Need Help?
If you get stuck at any point, email us at support@spexplorer.com and we will walk you through it. Include a screenshot of what you see and the URL of your SharePoint site.