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.

  1. Open your browser and go to the Microsoft 365 Admin Center: https://admin.microsoft.com
  2. 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)

  3. In the SharePoint Admin Center, click Sites in the left sidebar, then click Active sites.
  4. Find the site where you want to install SPExplorer. Click on the site name to select it.
  5. A panel will open on the right. Click the Settings tab.
  6. 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".

  7. Click Save.
  8. 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.

  1. Open PowerShell on your computer (search for "PowerShell" in the Start menu).
  2. If you have not installed the SharePoint module before, run this command first:
    Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
  3. Connect to your SharePoint admin site. Replace yourtenant with your organisation's name:
    Connect-SPOService -Url https://yourtenant-admin.sharepoint.com

    You will be prompted to sign in. Use your admin account.

  4. Enable custom scripts on your site. Replace the URL with your actual site:
    Set-SPOSite -Identity https://yourtenant.sharepoint.com/sites/YourSite -DenyAddAndCustomizePages 0
  5. 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.

1

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

2

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.

3

Upload the file

Click Upload in the toolbar (or Upload → Files), then select the SPExplorer.aspx file from your computer.

4

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.

5

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:

  1. Download the latest SPExplorer.aspx file from your purchase page.
  2. Go to the same SiteAssets library where the current file is stored.
  3. Upload the new file and choose Replace when prompted.
  4. 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.