# How To Open an HTML File on iPad (Files, Mail, Safari)

Canonical: https://commareports.com/open-html-file-on-ipad
Published: 2026-11-18

> An .html file on an iPad opens as a Quick Look preview, raw code, or a blank page instead of in Safari. Why iPadOS does that, what works for single files, zips and report folders, and the fix that always works.

# Opening an HTML file on an iPad

The iPad has a desktop-class Safari, a real file manager and a keyboard
case — so it feels like `report.html` should just open. It mostly doesn't.
You get one of these:

- Mail shows a preview with **no styling**, or the raw markup.
- The Files app opens a **preview** that looks half-right, with buttons
  that do nothing.
- There's no way to get the file into an actual Safari tab.

None of that is your iPad being broken. It's how iPadOS treats local files.

## Why there's no "Open in Safari"

On a Mac, a double-click hands `report.html` to Safari as a `file://`
page. iPadOS doesn't do that:

- Safari has **no Open File command**, and typing a `file://` path into
  the address bar does nothing.
- Local files — from Mail, Files, AirDrop or iCloud Drive — are shown by
  **Quick Look**, the system previewer, not by Safari.

Quick Look is a viewer for documents, not a browser. It's fine for a
single page of text and tables. It is not where a test report with tabs,
filters and charts comes to life.

## What works for a single self-contained file

If the `.html` really is one file — styles inline, images embedded, no
data loaded at view time:

1. In **Mail**, tap and hold the attachment, then **Save to Files**.
   (AirDrop and Messages offer the same option.)
2. Open the **Files** app and tap the file.
3. Quick Look renders it. Pinch to zoom; tap **Share** to send it on.

Good enough to read a static export. Expect interactive parts — collapsible
failures, sortable columns, charts drawn by JavaScript — to be missing or
inert.

## Zips and report folders

Most tools that produce "an HTML report" produce a **folder**: Playwright,
Allure, `genhtml` coverage, `nbconvert` with assets, Sphinx, Storybook. The
`index.html` points at sibling CSS, JavaScript and JSON.

On an iPad:

- Tap a `.zip` in Files and it **extracts** into a folder beside it.
- Tap `index.html` inside that folder and you get a Quick Look preview of
  that **one file** — its neighbours usually don't load, so it comes up
  unstyled or as an empty shell.
- A report that loads results with `fetch()` stays blank on any device
  when opened as a file, because local files get an opaque origin. That's
  not iPad-specific: see [CORS error: origin null](/fix/cors-error-file-origin-null).

If someone emailed only the `.html` out of the folder, nothing on the iPad
can fix it — the CSS was never sent. See
[why the report lost its CSS](/html-report-broken-css).

## The fix: open a URL, not a file

Whoever has the report on a laptop drags the file — or the whole output
folder, or the zip — into [Comma](https://commareports.com/) and sends the
link:

- `index.html` becomes the report, its assets upload alongside it, and
  relative references are rewritten to the uploaded copies.
- Scripts run in a sandboxed iframe, so the report stays interactive.
- On the iPad it opens in **real Safari** — and because iPad Safari asks
  for desktop sites by default, it lays out the way it does on the laptop
  it was built on.
- Readers can comment on the exact line they mean, with a free sign-in —
  or without one, if the owner allows guest comments on that link.

Need it to stay a file? The free [HTML inliner](/tools/html-inliner) folds
a report folder into **one** self-contained `.html` with CSS, JavaScript,
images and fetched data files embedded — the version that previews best
from the Files app.

## Making a report that reads well on an iPad

If you're the one producing it:

- Split View and Stage Manager give a page anywhere from a phone-width
  slice to a full screen — test narrow as well as wide.
- Add `<meta name="viewport" content="width=device-width, initial-scale=1">`
  and keep wide tables in a horizontally scrolling wrapper.
- Make tap targets at least 24px; there's no hover on a touchscreen, so
  don't hide details behind it.

The free [mobile-friendly test](/tools/mobile-friendly-test) checks the
viewport, text size, tap targets and horizontal scroll in one go. If it
looks tiny, see [HTML report tiny on a phone](/fix/html-report-tiny-on-phone).

## Is it safe to open?

An `.html` file can contain scripts. Treat it like any attachment — only
from senders you trust. Comma renders report HTML in a sandboxed iframe with
no same-origin access, so a script in a report can't reach your session,
cookies or storage. That's a containment boundary, not a malware scanner.

## Try it

Comma is free — unlimited reports, unlimited commenters, unlimited revision
history. Reading a shared link needs no account.

**[Turn the file into a link →](https://commareports.com/)**

### Related

- [Open an HTML file on iPhone](/open-html-file-on-iphone) · [on Android](/open-html-file-on-android) · [on a Chromebook](/open-html-file-on-chromebook)
- [Someone sent me an HTML file](/open-html-file-online) — on Windows or Mac
- [Gmail shows an HTML attachment as code](/fix/gmail-html-attachment-shows-code)
- [Safari .webarchive files](/glossary/webarchive) — the Mac saved-page format
- [HTML inliner](/tools/html-inliner) · [Mobile-friendly test](/tools/mobile-friendly-test)
