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:
- In Mail, tap and hold the attachment, then Save to Files.
(AirDrop and Messages offer the same option.)
- Open the Files app and tap the file.
- 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.
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.
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 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 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 checks the
viewport, text size, tap targets and horizontal scroll in one go. If it
looks tiny, see HTML report tiny on a 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 →
Related