Browser extension
A short guide for anyone installing PageStash from the Chrome Web Store, Firefox Add-ons, or a direct download. This page explains what the extension does, why it asks for certain permissions, and how we keep your captures tied to your account.
What you can capture
- Full page — scrolls the active tab and stitches a long screenshot, plus HTML and plain text extracted from the page you see.
- Visible area — one screenshot of what is on screen right now, with the same HTML and text extraction.
- Select area — drag a rectangle on the page to crop a screenshot; we still save page text and metadata where the browser allows.
Saving a page by pasting a URL in the web app is separate: that runs on our servers and may behave differently on sites that block automated fetches. The extension always captures the page as rendered in your browser.
Permissions and why we need them
| Permission | Purpose |
|---|---|
| activeTab | Act on the tab you opened the popup from: screenshot, read DOM for HTML/text, inject the area selector only when you ask. |
| storage | Keep you signed in locally (session tokens) and remember small preferences. We do not use this to track browsing history. |
| scripting | Run a short script in the active page to pull HTML and text, and to load the area-selection overlay when you choose that mode. Firefox requires this permission explicitly. |
| Host access (http/https) | Talk to PageStash APIs and Supabase over HTTPS to save clips and sync your library. We do not inject scripts into arbitrary sites in the background. |
| tabs (Firefox) | Firefox needs this for tab/window APIs used during capture (e.g. visible-tab screenshots). |
Security and your data
- You sign in with email and password (or your existing PageStash account). Session tokens are stored in the extension and sent only over HTTPS to our backend.
- Clips — screenshots, HTML, text, titles, URLs — are stored under your user account in our database and file storage, with access controlled so only you can read your own content.
- We do not sell your saved pages or use them to train third-party models. For retention, third-party processors, and legal rights, see our full Privacy Policy.
Technical overview
Built as a small, focused extension on top of the same stack as the dashboard:
- Chrome / Edge — Manifest V3 background service worker; popup UI saves clips via authenticated HTTPS API routes.
- Firefox — Manifest V2-compatible build with the same capture logic, adapted for Firefox's extension APIs.
- Capture pipeline: read page DOM in the active tab → take screenshot(s) → upload image and metadata to secure storage → attach the clip to your account so it appears on the dashboard.
Official installs
Prefer store builds for automatic updates and verified packages.
Questions? support@pagestash.app