> 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/using-yeymail/aliases.md). # Aliases An alias is an email address that forwards to an inbox you already read. Mail arrives with the real sender's name and address kept in the from line; your real address is never in the message. ## Creating one **Aliases → New alias.** Choose the local part (the bit before the `@`) and the domain: `@yeymail.com`, or any custom domain you've verified. **Random** generates an unguessable local part if you'd rather not invent one. A label is optional and only ever visible to you. It's worth using: six months later, `k4x2p8@yeymail.com` tells you nothing, and "Zalando" tells you everything. ## Switching one off Every alias has a switch. Turned off, mail to that address is **refused at the door**. The sending server gets an immediate "no such address", nothing is queued, and nothing reaches you. The sender is told their message failed, which is deliberate: silently discarding mail is worse than bouncing it, because the sender believes it arrived. Your other aliases are unaffected. Your real address was never exposed to begin with. **The switch works on every plan, including after a subscription lapses.** Shutting down an address that is actively leaking should never sit behind a paywall. ### Automatic shut-off Turn on **Auto-block on leak** in Settings and we'll switch off an alias for you when it takes **10 spam rejections within 60 minutes**. You get an email telling you which alias and why, and you can turn it back on in a click if we got it wrong. **This only covers aliases on `@yeymail.com`.** The check that spots those rejections looks for the shared domain by name, so an alias on a domain of your own is never switched off automatically; on those you'll need to use the switch yourself. ## Where mail goes By default, to the address you signed up with. You can add more destination inboxes in Settings (each has to be confirmed by clicking a link we send to it) and then point each alias wherever you like. An alias can deliver to several inboxes at once. Starter allows 10 destination inboxes; Plus removes the cap. That's what makes a family or team plan work: everyone receives their own mail. ## Is "unlimited" really unlimited? **On your own domains, yes.** Create as many as you like. **On the shared `@yeymail.com` domain, there's a ceiling** on how many you hold at once: 500 on Starter, 5,000 on Plus, 25 during a trial. There's also a rate limit on creation (300 a day on Starter, 600 on Plus). The reason is worth understanding, because it's a design decision rather than an upsell. Claims on the shared domain are **permanent**: an address you create is never given to anybody else. Without a ceiling, a single script could create and delete in a loop and permanently burn every good local part on the domain while never holding more than one alias at a time. A rate limit alone can't stop that; it sets the speed, not the total. Because claims are permanent, an address you've deleted still counts toward the number you hold on `@yeymail.com`. You are still holding it. Nobody else can have it. If you need that space back, email support. No real user has come close to these numbers. ## Deleting Deleting an alias stops it forwarding and removes it from your list, but **not the address itself**. That address stays reserved to you permanently (always, not only if it carried mail). Nobody else can ever register it, whatever happens to your plan. It's the same protection as above, pointed at you: an address that once received your password resets can never end up in someone else's inbox. We used to release an address that had never received anything, on the reasoning that it had protected nobody. That was wrong. An address handed out on a business card and deleted before the first reply arrives looks untouched from our side, and releasing it would have handed a stranger mail meant for you. So nothing is released. The alias also stays in your **activity**, so if you removed the wrong one you can look up the address and create it again. ## Limits at a glance | | Trial | Starter | Plus | | ------------------------------ | --------- | --------- | --------- | | Aliases on your domains | Unlimited | Unlimited | Unlimited | | Held at once on `@yeymail.com` | 25 | 500 | 5,000 | | Created per hour | 15 | 60 | 120 | | Created per day | 50 | 300 | 600 | | Destination inboxes | 2 | 10 | Unlimited | Addresses you've deleted count toward the "held at once" row, because they stay reserved to you. --- # 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/using-yeymail/aliases.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.