Skip to main content

Page (HTML)

Page (HTML) in SharePoint renders a single uploaded or Copilot-generated HTML file as a page from the Site Pages library, inside a sandboxed frame. Uploads are limited to 10 MB, scripts run only from the same file, and outside links need an allow-list entry.
Related
Copilot in SharePoint, Page, Page (ASPX), Page Analytics, Page Sections, Site Pages Library
See It In Action

Common Use Cases

  • Department reference pages: emergency procedures, wellness programs, and benefits overviews that change a few times a year
  • Campaign and launch pages: one-off pages that need a branded, magazine-style layout
  • Interactive explainers: tabs, accordions, and calculators built with script inside the same file
  • Data visual pages: charts drawn with the Microsoft-hosted Chart.js or Mermaid libraries
  • Exported designs: pages designed in another tool and uploaded as finished HTML
  • Copilot drafts: pages generated from a prompt in Copilot and refined in the chat pane

Benefits

  • Full design freedom: layouts, fonts, and effects that the section and web part canvas cannot produce
  • One portable file: the whole page lives in a single file that is easy to copy to other sites
  • No custom development: no SPFx solutions, app catalog, or third-party tools are involved
  • Secure by design: the sandbox keeps page code away from the rest of SharePoint
  • No extra license to upload: uploading, editing text, publishing, and viewing need no Copilot license
  • Familiar publishing: pages use the same Publish and Share buttons as other site pages

Details

  • Feature Category: Pages & Publishing
  • Storage: the .html file is stored in the Site Pages library
  • Supporting files: images and videos uploaded with the page go to the Site Assets library
  • Upload size: 10 MB per page, not counting images and videos
  • Availability: on by default for every site, rolling out from October 2026
  • Licensing: a Microsoft 365 Copilot license is needed only for Copilot creation and chat edits

How It Works

  • Create or upload: use + New > HTML page, the Copilot button, or Create or upload in Site Pages
  • Sandboxed rendering: the page renders in an isolated frame with its own Content Security Policy
  • Same-file scripts: JavaScript runs only when it is written inside the HTML file itself
  • Approved libraries: only Microsoft-hosted Chart.js, Mermaid, React, Fluent UI, and Babylon can load
  • Inline editing: authors change text directly in edit mode and use Copilot for larger changes
  • Link rules: links within the tenant work, while outside domains need an HTML Field Security entry

Limits and Nuances

  • No web parts: News, Events, Highlighted content, and other web parts cannot be added
  • No outside data calls: fetch requests, outbound API calls, and localStorage are blocked
  • No news or templates: pages cannot be promoted to news, saved as templates, or scheduled
  • No co-authoring or comments: private drafts, co-authoring, comments, and reactions are unavailable
  • No automatic branding: uploaded HTML keeps its own styles unless Copilot is asked to match the site
  • Site-level switch only: owners turn HTML pages off per site under Site Pages > File types, with no tenant-wide control

Common Questions About HTML Pages

What is an HTML page in SharePoint?

An HTML page is a SharePoint page built from a single HTML file instead of sections and web parts. The file is stored in the Site Pages library and rendered inside a sandboxed frame, separate from the site header, footer, and navigation. Authors can upload a finished file, upload a folder with supporting files, or ask Copilot to generate the page, then publish and share it like any other page.

What is the size limit for an HTML page?

Each upload can be up to 10 MB, not counting images and videos. Images and videos included with the page are moved to the Site Assets library, so they do not count toward the limit. Pages that carry their images inside the file as base64 data grow quickly, so compressing photos and trimming unused CSS and script keeps a page well under the ceiling.

How is an HTML page different from a regular ASPX page?

A regular page is the native SharePoint canvas made of sections and web parts, with news, templates, scheduling, approvals, co-authoring, and comments. An HTML page trades those publishing features for full design control. It cannot hold web parts or pull live news and events, but it can deliver custom layouts, tabs, and interactive elements that the standard canvas does not offer.

Can an HTML page run JavaScript?

Yes, as long as the script is written inside the same HTML file. Scripts loaded from outside sources are not supported, with the exception of Microsoft-hosted versions of Chart.js, Mermaid, React, Fluent UI, and Babylon. The sandbox blocks arbitrary fetch requests, outbound API calls, and browser localStorage, so scripts are best suited to tabs, accordions, filters, and other in-page interactions.

Why do some links on an HTML page not open?

Links inside the same site or tenant work by default, and anchor links within the page work too. Links to websites outside SharePoint are blocked until a site owner adds the domain to the HTML Field Security allow list under Site settings. Without that entry, readers see a message saying the organization does not allow access to the site.

When should I use an HTML page instead of a regular page?

HTML pages suit reference content that changes rarely and benefits from a richer layout, such as emergency procedures, wellness programs, or onboarding guides. Content that changes often, or that needs news, events, and document libraries, belongs on a regular page with web parts. Greg Zelfond, the consultant behind LookBook 365, pairs the two by keeping department home pages on out-of-the-box web parts and adding HTML pages as polished secondary pages.