SharePoint Document Issues

Fix SharePoint Online Downloading ASPX Pages Instead of Displaying Them

John WilsonJohn Wilson Nov 14, 2026 868 views

Question details

The user needs external help-authoring ASPX pages to display in SharePoint Online instead of downloading.

Fix SharePoint Online Downloading ASPX Pages Instead of Displaying Them
Product
SharePoint Online
Device & OS
not provided
Scenario
ASPX files generated by an external help-authoring tool are uploaded to a SharePoint library for users to view.
Observed behavior
The uploaded ASPX pages download rather than render in the browser.
Before you start

Identify the library containing the ASPX files and check whether you have access to the site's Pages or Site Pages library. Ask a SharePoint administrator about the site's script restrictions and any policies affecting custom pages.

Solution 1Recommended

Test the ASPX page in a SharePoint page library

Use this approach to check whether the library location or site configuration affects how the page opens.

A Pages or Site Pages library may handle an ASPX file differently from its original location, but moving the file does not guarantee that an externally generated page will render. SharePoint Online does not run arbitrary server-side ASP.NET code from uploaded pages.

1
Find a page library

On the SharePoint site, open Site contents and look for Pages or Site Pages. Ask the site owner for access if the library is unavailable.

2
Upload a test page

Open the page library, select Upload, and add a test ASPX file. Include any required supporting files in an appropriate location, preserving their relative paths where possible.

3
Open the page

Select the uploaded ASPX file in the library and check whether it renders or downloads. Also check whether images, links, and other supporting content load.

4
Review restrictions

If the page still downloads or does not work, share the file location and test result with a SharePoint administrator. Ask them to review site permissions, custom script restrictions, and applicable security policies.

Test the ASPX page in a SharePoint page library
Script and page compatibility: Do not enable custom scripts solely to bypass the download behavior without an administrator's security review. Allowing custom scripts also does not make unsupported server-side ASP.NET code run in SharePoint Online.
Free Microsoft Office alternative

Create Help Documents with WPS Office

WPS Office is a free, lightweight Office alternative with a familiar interface and compatibility with common Microsoft Office formats for a smoother move between suites. It can help you prepare help documents, but it does not fix SharePoint Online ASPX rendering.

Draft and edit help documentation in WPS WriterCompatible with common Microsoft Word DOC and DOCX formatsUse a familiar interface for everyday document editingWork with a free, lightweight Office suite
microsoft office alternative - wps office

Frequently Asked Questions

Can an ASPX file open from a SharePoint document library?

It may, depending on the library, site configuration, and the page itself. Test it in Pages or Site Pages through Site contents, but do not assume the library location alone will make an external page render.

Will enabling custom scripts make my external ASPX page work?

Not necessarily. Custom script restrictions can affect page customization, but SharePoint Online does not run arbitrary server-side ASP.NET code from uploaded pages. Ask an administrator to review compatibility and security before changing script settings.

How can I display the help content if the ASPX file is incompatible?

Select New > Page on the SharePoint site and recreate the content using supported web parts such as Text and Image. Publish the page and test its links and media.

Do I need SharePoint Designer to access the Pages library?

Not always. First try Site contents > Pages or Site Pages in the browser. For a classic page workflow that requires SharePoint Designer, ask your administrator whether that workflow and tool are supported and permitted in your environment.