Fix SharePoint Online Downloading ASPX Pages Instead of Displaying Them
Question details
The user needs external help-authoring ASPX pages to display in SharePoint Online instead of downloading.

- 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.
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.
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.
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.
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.
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.
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.

Recreate the help content as a modern SharePoint page
Use supported SharePoint page components when the external ASPX page is incompatible with SharePoint Online.
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.

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.




