SharePoint Document Issues

How to Fix SharePoint ASPX Files Downloading Instead of Opening

Bushra Parveen Sep 28, 2026 869 views

Question details

Users are experiencing an issue where ASPX pages uploaded to SharePoint are forcibly downloaded to their local machine rather than rendering as a web page in the browser.

How to Fix SharePoint ASPX Files Downloading Instead of Opening

Product: SharePoint
Device & OS: not provided
Scenario: Attempting to open custom or uploaded ASPX files hosted on a SharePoint site.
Observed behavior: The browser downloads the ASPX file instead of displaying the page content, and modifying URL parameters does not bypass this download behavior.

Before you start

Ensure you have the necessary site permissions to view site settings and content types, or prepare to contact your SharePoint tenant administrator, as this issue is often tied to tenant-level security configurations.

Solution 1Recommended

Compare File Configurations and Publishing Settings

Identify discrepancies by comparing affected ASPX files with those that still open correctly in the browser.

In many cases, certain ASPX files may have different metadata, content types, or publishing statuses that trigger the download behavior.

Locate the Files

Navigate to the SharePoint document library or Site Pages library hosting the ASPX files.

Analyze a Working File

Select an ASPX file that still opens normally. Check its properties to note its Content Type, specific folder location, and permission levels.

Update the Affected File

Open the properties of the downloading ASPX file and ensure its Content Type and permissions strictly match the working file.

Check Publishing Status

Ensure the affected page is properly checked in and published as a major version, as draft items may behave differently for standard users.

Compare File Configurations and Publishing Settings

Avoid Unsupported Workarounds: Avoid relying on unsupported URL modifications or web parameter hacks, as these do not resolve the underlying configuration issues and may break entirely during future SharePoint updates.

Solution 2

Request a Tenant-Level Investigation from an Administrator

Security policies or custom script restrictions at the tenant level often force ASPX pages to download to prevent unauthorized code execution.

Free Microsoft Office alternative

Experience Hassle-Free Document Management with WPS Office

Dealing with complex SharePoint configurations and server-side file restrictions can slow down your daily workflow. WPS Office offers a free, lightweight, and highly compatible alternative to Microsoft Office, letting you create, edit, and manage your standard documents without enterprise-level administration headaches.

1. Download the Installer: Visit the official WPS Office website and download the free installation package.
2. Install WPS Office: Run the installer and follow the quick on-screen instructions to set up the suite on your device.
3. Open and Edit Documents: Launch WPS Office to instantly open, edit, and save your existing Office documents with full formatting support.

Completely free and lightweight office suiteSeamless compatibility with Microsoft Word, Excel, and PowerPoint formatsFamiliar, intuitive user interface requires zero learning curveBuilt-in PDF editing capabilities for comprehensive document control

microsoft office alternative - wps office

Frequently Asked Questions

Why did my SharePoint ASPX files suddenly start downloading?

This behavior is typically triggered by tenant-level security updates from Microsoft, such as disabling custom scripts, which prevents active server pages from executing in the browser to maintain strict security compliance.

Will changing the URL parameters fix the ASPX download issue?

No. Modifying URL parameters or applying unsupported URL changes generally does not bypass SharePoint's built-in security policies that enforce the file download.

Are ASPX files being phased out in SharePoint?

Microsoft routinely tightens security around custom code and active pages. It is highly recommended to consult the Microsoft 365 Message Center or official documentation for any upcoming deprecations regarding custom ASPX files in your specific environment.

Document & File Issues