> For the complete documentation index, see [llms.txt](https://docs.yeymail.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yeymail.com/advanced/browser-extension.md). # Browser extension The extension watches for email fields on signup forms and offers you a fresh alias right inside them. One click (or Tab) creates the alias and fills it in, so your real address never touches the page, and you never have to open the dashboard mid-signup. **Install it:** [Chrome, Edge, Brave and Opera](https://chromewebstore.google.com/detail/yeymail-%E2%80%94-email-aliases/jmcfiehfabhpeimfajkdaojagldaiglp) ยท [Firefox](https://addons.mozilla.org/en-US/firefox/addon/yeymail-privete-email-aliases/) ## What it does * **Suggests an alias on any signup form.** The suggestion appears as a dashed pill inside the email field itself. Nothing covers the form, and the password field is never blocked. Press Tab or click the pill to take it; start typing, or press Esc, and it collapses to a small mark at the edge of the field so you can bring it back later. * **Creates it on use.** The alias only exists once you accept it, so forms you abandon leave no clutter behind. * **Knows a signup from a sign-in.** It offers on forms that ask you to *set* a password, and stays out of the way on login forms, where your real address is the one that belongs there. * **Offers your own domains.** As well as `@yeymail.com` you can pick any custom domain you've verified, so the address matches the rest of your identity. * **Manages aliases without the dashboard.** The popup lists every alias with a search box and an on/off switch, so you can kill one that has started attracting spam from wherever you are. * **Switches tracker removal on for the site you're on.** If the current site already has one of your aliases, the popup shows a **Remove trackers** switch for it. That is the same per-alias setting as the one on the Aliases page, at the moment you're thinking about that site. * **Cleans tracking links as you browse**, if you want it to. See below. ## Choosing when it appears Under **Settings** in the popup you can pick when a suggestion is offered: * **On signup forms only**, the default. An email field with a new password beside it. * **On every email field.** * **Only when I click the icon**: nothing appears on its own; you ask for an alias when you want one. Any site you've used **Never offer on this site** on is listed there too, and can be removed in one click. ## Clean tracking links Most links you follow carry a tag identifying you: `utm_source` on a newsletter link, `fbclid` after a click from Facebook, `gclid` from an ad. They tell whoever placed the link where you came from and let separate visits be joined into one profile. Turn on **Clean tracking links** in the extension popup and those tags are removed from the address before the page loads. 78 of them, including every `utm_` variant and the click identifiers used by the major ad networks. **The link still works.** Only the part that identifies you is dropped. The page, the product, the article you clicked through to all load exactly as before. ### What it deliberately leaves alone * **Anything that isn't tracking.** Search terms, page numbers, sign-in redirects, checkout and order references, session tokens: all untouched. Short generic names like `ref` and `source` are left alone on purpose, because sites use them for real navigation and removing them breaks pages. * **Everything except the page address.** Only top-level navigations are cleaned. What a page's own scripts fetch afterwards is how applications talk to their servers, and rewriting that breaks things without telling you anything the address bar hadn't already. ### Why it asks for access to all sites Cleaning a link means acting on whatever site you're about to open, so it can't be limited to a fixed list. Cleaning is an **optional** permission and the rules ship switched off, so nothing is cleaned until you turn the setting on. Your browser's install prompt still asks for access to every site, because the part that offers aliases has to spot an email field on whatever signup form you open. Your browser applies the rules itself. The extension is not sent your browsing history and does not see, store or transmit the addresses you visit. Turn the setting off and the rules stop. If you later remove the site access from your browser's own settings, the popup will show the feature as **Paused** rather than pretending it's still working. ### It's separate from tracker removal in email The two do a similar job in different places, and you can use either without the other: | | Where it works | Turned on | | ------------------------ | ------------------------------- | -------------------------------------------- | | **Clean tracking links** | Pages you open in this browser | Once, in the extension | | **Remove trackers** | Mail forwarded through an alias | Per alias, in the dashboard or the extension | The mail-side one also strips the invisible tracking pixel that reports when you open a message, which a browser extension can't reach. See [Privacy controls](/using-yeymail/privacy-controls.md). ## Connecting it to your account The extension never asks for your password. When you install it, it shows a code and opens a page in your browser; you approve the connection while signed in, and the extension receives its own access key. You can see every connected extension under **Settings** and revoke any of them instantly. Revoking takes effect immediately, so a lost or shared device can be cut off without changing your password. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.yeymail.com/advanced/browser-extension.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.