How to Save a Webpage as a Single HTML File with SingleFile
Save a complete webpage as one HTML file with SingleFile. Follow the browser steps, learn what may not work offline, and see when a screenshot is a better fit.
To save a webpage as one HTML file with SingleFile, install the extension for your browser, open the page, wait for it to finish loading, and click the SingleFile toolbar button. The extension packages the page and its resources into a standalone HTML file, which the browser saves to its configured downloads folder by default. The file is useful for offline reading and sharing, but it does not guarantee that every interactive feature or protected resource will work later.
What SingleFile saves
SingleFile is a browser extension, also available as a command-line tool, that saves a complete webpage into a single HTML file. It aims to include page content and resources such as CSS, images, and fonts. The result is one file rather than an HTML document that depends on a separate folder of downloaded assets. See the official SingleFile project for current downloads and platform details.
SingleFile may fetch resources present on the page even if they were not displayed or already in the browser cache. A saved page is therefore a snapshot of what the tool could access during capture, not a promise that the original site will be reproduced in every detail.
Save a page with the browser extension
- Install SingleFile from your browser’s official store. The project links to listings for Firefox, Firefox for Android, Chrome, Safari, and Edge. It also lists support for Microsoft Edge, Vivaldi, Brave, Waterfox, Yandex Browser, and Opera. Availability and installation steps vary by browser and platform, so use the project’s current installation links.
- Open the page you want to keep. Sign in or load content first if the page requires it and you are permitted to save it.
- Wait until the page is fully loaded. If images, fonts, or other content are still appearing, give them time to finish. Pages that load content as you scroll may need you to scroll through the relevant sections before capture.
- Click the SingleFile icon in the browser toolbar. The extension processes the page and downloads an HTML file. You can click the icon again while processing to cancel.
- Open the downloaded file from the browser’s download list or downloads folder. The default destination is the browser’s configured download folder.
The exact filename and any prompts depend on SingleFile’s settings and the browser’s download preferences. The project’s help documentation describes available options.
Choose a different capture action
For more than a normal page capture, right-click the SingleFile button or the webpage and inspect the available context-menu actions. Depending on the browser and extension version, these include saving selected content, capturing a frame, handling multiple tabs, annotating a saved page, and enabling automatic saves. Check the extension’s menu and current help page for the exact action names supported in your installation.
SingleFile also documents a customizable Ctrl+Shift+Y keyboard shortcut. Browser extension shortcut settings let you change shortcuts where supported. A shortcut can be useful for repeated captures, but verify the configured key in your browser rather than assuming the default is active.
What may not be preserved
- Protected browser pages: browser security prevents extensions from accessing certain pages, including Chrome Web Store and Mozilla add-on pages. If SingleFile cannot run there, this is an access restriction rather than a broken download setting.
- Canvas and video: a canvas image or video snapshot may be inaccessible to the extension. The saved file can therefore omit that visual content.
- Interactive behavior: folding headings, maps, carousels, and similar features may not work offline. SingleFile removes scripts by default because scripts can alter rendering and are not guaranteed to work after saving. Changing options does not guarantee the original site behavior will return.
- Content that was never loaded: lazy-loaded images or sections may be absent if the page did not load them before capture. Scroll through the content you need, then save again.
- Content behind access controls: a saved file cannot preserve material the browser was unable to load or the extension could not access.
The default output is HTML and the project help describes it as opening without requiring JavaScript. SingleFile offers other format options; consult its current settings if HTML is not the format you need.
Troubleshooting
| Problem | Likely cause | What to try |
|---|---|---|
| No file appears | The page is still processing, the browser blocked or redirected the download, or the save was canceled. | Check the browser’s download list and blocked-download indicator. Wait for processing to finish, then try again. Avoid clicking the toolbar button a second time unless you intend to cancel. |
| The toolbar button is unavailable | You are on a protected browser page or a page the extension cannot access. | Try an ordinary website page. Store and add-on pages are among the known restricted locations. |
| Images or fonts are missing | The resource did not load or was inaccessible when the page was captured. | Wait for the page to finish loading, scroll to trigger lazy content, and save again. If it is a canvas or video image, the browser may not expose it to the extension. |
| The saved page looks different | Some resources, scripts, or dynamic page state could not be packaged; scripts are removed by default. | Compare with the live page, check SingleFile’s options and help, and treat the file as a readable snapshot. Re-enabling script-related behavior does not ensure full interactivity. |
| Only part of the page was saved | The page had not finished loading, or you used a selection/frame action rather than a full-page action. | Wait for loading to complete and use the normal toolbar capture. For intentionally partial captures, choose the relevant selection or frame action. |
| The file is hard to find | The browser uses a custom downloads folder or asks where to save files. | Open the browser’s downloads view and check its download location preferences. |
When SingleFile is the right tool
Choose SingleFile when you want a self-contained HTML snapshot for offline reading, reference, or sharing, and the page can be accessed in your browser. It is not a professional web-archiving tool. If you need an archival workflow with preservation and provenance requirements, do not treat a SingleFile file as a substitute; its FAQ explicitly makes this distinction. Consult the official FAQ for the project’s limitations.
If all you need is a visual record to embed in a document or review later, an image or PDF may be more suitable than a self-contained HTML page. ScreenshotNeo is a website screenshot API and MCP server from ScreenshotNeo; it returns a PNG, JPEG, WebP, or PDF from a GET request. A screenshot preserves appearance rather than page structure or offline interactivity.
Or skip the browser setup
For a visual capture instead of a saved HTML document, ScreenshotNeo can return a screenshot through one API call. See the API documentation for the complete parameter reference.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpimport requests
r = requests.get(
"https://api.screenshotneo.com/v1/shot",
params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"},
timeout=90,
)
open("shot.webp", "wb").write(r.content)const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
if (!res.ok) throw new Error(`Screenshot request failed: ${res.status}`);
await Bun.write('shot.webp', res);ScreenshotNeo accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks, blank pages, failed loads, timeouts, and cache hits cost nothing, and response headers report the page verdict and billing status. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots.
Create a free ScreenshotNeo account for 1,000 screenshots a month with no card.
FAQ
Does the saved page need an internet connection?
The purpose of the self-contained HTML output is offline viewing. However, inaccessible or dynamic content may not be included, so offline appearance and behavior can differ from the live page.
Can I save several tabs?
SingleFile provides context-menu actions for multiple tabs. Check the extension menu and its current help documentation for the supported workflow in your browser.
Is SingleFile suitable for legal or scholarly archiving?
The project FAQ says SingleFile is not a professional web-archiving tool. Use a workflow designed for your preservation and provenance requirements when those matter.
Does a screenshot replace a SingleFile HTML file?
No. A screenshot records visual appearance as an image or PDF; SingleFile creates an HTML snapshot intended for offline reading. Choose based on whether you need a picture of the page or a saved document.
