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.

Free · no card

Turn your report into a link

Drop an HTML file or paste it. Teammates open one URL and comment on the exact chart or line.

Your file is read in this tab and nothing is uploaded until you publish. Creating an account is free, and reading a shared link never needs one.

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.

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

Have an HTML report to share? Publish it free and send one link people can comment on.