Help menu Reference
Settings reference
Every Settings section, its controls and their starting values.
Open Settings and select a section. On a phone, the sections form a list; select one to open it, and All settings to go back. In the web inbox, Browsers, Backup & transfer and Troubleshooting show "On your computer": change them in Mailman there.
Defaults are for a fresh install. Yours may differ. Switches and choices save when you change them. In Sync, the row then shows "Saved ✓", and number fields save when you leave the field or press Enter. Forms with a save button need it.
Connections#
Sync#
When Mailman checks your accounts. It always downloads the Inbox and Junk. Add other folders per account under Monitored folders.
| Setting | What it does | Default |
|---|---|---|
| Sync accounts automatically | Re-checks every account on a schedule. When off, accounts sync only when you select Sync everything now, sync one account, or a realtime push arrives. | Off |
| Start syncing when Mailman opens | Syncs every account at launch, and keeps syncing if automatic sync is on. When off, realtime inboxes catch up when their next message arrives, or when you sync the account. | Off |
| Retry failed syncs on another proxy | After a sync fails with no mailbox access, a rate limit or a dead proxy, retries on up to 2 proxies from the saved list you pick. The proxy that works becomes the account's proxy. Change it on your computer. | Off |

Under Realtime push, Relay connection keeps a connection open so Outlook inboxes update the moment mail arrives. Its status reads "Connected" with the number of live inboxes, or "Disconnected".
Open Advanced limits to change how hard Mailman works the network. Lower them if proxies or providers start refusing connections. Caps apply at once; accounts already syncing finish first. Every cap is also limited by Connections at once.
| Setting | What it does | Default |
|---|---|---|
| Connections at once | Open connections across all accounts. | 1,000 (1 to 5,000) |
| Check every account | Seconds between passes over an account. Shown only when automatic sync is on. | 900 (60 to 86,400) |
| Automatic sync minimum interval | Seconds between automatic syncs of the same account. | 60 (30 to 3,600) |
| Per-proxy connections | Connections at once through one proxy. | 4 (1 to 50) |
| Per-provider connections | Default cap for every provider. | 200 (1 to 5,000) |
| Provider overrides | A different cap for one provider. Select Add override. Each provider once. | None |
Tasks API#
Your tools get verification codes and links from your inboxes. Keep Mailman open on your computer. See Let a compatible tool collect codes.
| Setting | What it does | Default |
|---|---|---|
| Enable Tasks API | Turns the connection on or off at once. The status reads "Connected", "Connecting…", "Disconnected" or "Tasks API off". Change it on your computer. | Off |
| API key | Select Copy to paste it into your tools. Regenerate stops the old key. It stays on your computer. | Hidden |
| Maximum active inboxes | Under Advanced. How many inboxes Mailman watches at once; extra ones wait. Select Save task settings. | 200 (1 to 10,000) |
| Create template | Picks which inboxes a task watches. The ID can't change later, and edits apply to new tasks only. | None |
| Developer tools | The full test builder for selectors, regular expressions and formatters. | — |

Remote access & API#
Use Mailman from a browser, or let agents and scripts read mail and sync accounts.
| Setting | What it does | Default |
|---|---|---|
| Open Sharing | In the Read-only sharing card at the top. Opens the Sharing page, where you give someone else read-only mail. | — |
| Remote access | Under Web inbox. Lets you use your inbox at inbox.getmailman.app while this computer is on. Anyone signed in to your Mailman account can use it, with full access. Turn it on or off on the computer. | Off |
| Turn on local API | REST and MCP on this computer, for tools you run here. | Off |
| Port | The local API port. Select Apply after changing it. | 7357 |
| Add client | Creates a token for one tool. Revoke ends its access. | None |
| Create remote key | A full-access key for your own tools on other computers. Copy it when it appears: Mailman won't show it again. For someone else, use Sharing. | None |
| Connector URL | The address you paste into Claude's connector settings. Connected apps appear below it; Revoke cuts one off. | — |
Recent calls appear under Activity for 14 days or 10,000 entries. Message content is never recorded.
Notifications#
Alerts#
Post to Discord or a JSON webhook when mail matches. Keep Mailman open to deliver alerts. Create and edit on your computer. See Get alerts for the mail you care about.
| Setting | What it does | Default |
|---|---|---|
| Add destination | Where alerts are posted: Discord or a webhook. Select Send test to check it. | None |
| New rule | What to watch for: a sender or subject, tags, or order statuses. Pick destinations and accounts. | None |
| Recent deliveries | The last 50 alerts sent. | — |
Forwarding#
Mailman forwards matching new mail to other addresses while it's running. See Set up automatic forwarding.
| Setting | What it does | Default |
|---|---|---|
| New rule | Forwards mail from any listed sender whose subject has any listed keyword. Leave either empty to skip that filter. | None |
| Include junk | Also forwards mail filed in Junk. | Off |
Sign-in#
Browsers#
Browser sign-in runs a Chrome window for each account and uses about 300 MB while it runs. These settings are on your computer only.
| Setting | What it does | Default |
|---|---|---|
| Choose automatically | Mailman picks how many browsers run at once for this computer. | On |
| Browsers at once | The limit when automatic is off. Lower it if Microsoft shows "Too Many Requests". HTTP Outlook tools don't use Chrome and run under their own fixed limit of 50. | Automatic |
| Show sign-in browsers | When off, sign-in windows run hidden. Turn it on to watch a sign-in. Applies to sign-ins that start after the change. | Off |
| Sign-in proxy override | A proxy for browser sign-in only. Leave it blank to use each account's own proxy. | Blank |
| Sign-in fallback proxy list | Used only when an account's own proxy is blocked during sign-in. | None |
Mail#
Reading mail#
What Mailman downloads and what the Inbox shows. Older mail stays stored and searchable.
| Setting | What it does | Default |
|---|---|---|
| Ask before deleting | Asks each time whether to remove mail from Mailman only or delete it from the server. When off, Delete removes it from Mailman only. | On |
| How far back to download mail | Choose 30 days, 90 days, 6 months, 1 year or Everything. Raising it fetches older mail in the background; new mail still syncs first. Lowering it keeps mail already downloaded. Everything asks you to confirm. | 90 days |
| Smart stacking | Stacks emails from the same sender whose subjects differ by one word, like a name or order number, or only in the middle, like a product name between the same first and last words. | On |
| Phrase stacking | Also stacks subjects that share a phrase of four or more words. Needs smart stacking. | Off |
| Show images | Loads remote images when you open an email. When off, images wait until you select Load images, which also stops senders seeing when you read their mail. Saved per browser. | On |
A custom number of days saved earlier stays in the list, but you pick new values from the presets. Turning stacking on or off re-stacks your existing mail in the background, with a progress bar. The date button above the Inbox, such as "Last 30 days", changes only what you see, never what is downloaded.
Orders#
What the Orders page shows. Right-click an order or retailer there to hide or block it, or to hide every order to its address or alias. On a touch screen, press and hold.
| Setting | What it does | Default |
|---|---|---|
| Check carrier websites for delivery status | Opens UPS, FedEx and USPS tracking pages in a hidden Chrome window on this computer's connection a few times a day for packages still on the way. | On |
| Fallback proxy list | When a carrier refuses this computer's checks, retries them on up to 3 proxies from the saved list you pick. The proxy that works keeps checking that carrier until it is refused too. Change it on your computer. | Off |
| Check Shopify stores for order updates | Quietly checks Shopify orders using the order link in your emails, for cancellations, refunds, package tracking and product photos. Checks are spread over the fallback proxy list when one is selected. The order drawer shows successful check times; failures stay silent. | On |
| Hidden orders | Orders you hid are left out of Orders, its totals and CSV exports. Select View list, then Unhide. | None |
| Blocked retailers | Every order from a blocked retailer is left out, including new ones. Select View list, then Unblock. | None |
| Orders hidden by address or alias | Every order shipping to a hidden address or emailed to a hidden alias is left out, including new ones. Select View list, then Unhide. | None |
AI classification#
Sorts each stack into smart views and highlights possible wins. Nothing is deleted or hidden automatically.
| Setting | What it does | Default |
|---|---|---|
| Enable AI classification | Turns sorting on. It is independent of smart stacking. A sender, subject and body excerpt are sent for sorting. This switch does not control reading order items. | Off |
| Reclassify | Classifies stacks with mail in the range you pick again. Tags you set and sender rules are kept. | — |
| Recent tag corrections | Your latest corrections to tags. | — |
Reading missing order items has its own Read missing items with AI switch in Settings → Orders, off by default. It sends the order email's text to Mailman's AI, which can include delivery names, delivery and billing addresses, phone numbers, email addresses and the last four digits of a payment card. Mailman's servers do not store that text. Items already learned can still be read with this separate switch off. See Orders.
Labels are shared with other Mailman users only as a digest of the sender and subject, never the email. If your install uses its own AI key, Provider and an API key row appear too. You enter the key on your computer.
Tags#
Custom labels for mail. Create tags here, and teach automatic tagging with examples. See Label mail and accounts with tags.
| Setting | What it does | Default |
|---|---|---|
| New tag | Creates a tag. You can have up to 250. | None |
| Automatic tagging | Per tag: teach examples, preview matches, pause or remove automatic tags. | Off |
Organizing rules#
A rule is a saved search plus what to do with the mail it matches. Rules run before the AI, on existing and new mail, and stay on this device. See Sort mail with your own rules.
| Setting | What it does | Default |
|---|---|---|
| New rule | Stack together, tag, mark as spam, hide, move to a view, mark as read, or never spam. | None |
| Sender rules and muted senders | Open them with Manage sender rules and muted senders ›. Muted senders' new mail is skipped. | None |
Data & security#
Backup & transfer#
Move Mailman to another computer with an encrypted backup. These settings are on your computer only. See Back up Mailman and move computers.
| Setting | What it does | Default |
|---|---|---|
| Include mail | Adds your mail to the backup. Without it, mail downloads again on the new computer. | Off |
| Passphrase | At least 12 characters. Mailman doesn't store it, so a lost passphrase can't be recovered. | Blank |
| Export backup | Saves the file. It always includes accounts with their passwords and tokens, proxies, rules, alerts and settings. | — |
| Import and restart… | Replaces the data on this computer with the backup you open. | — |
Troubleshooting#
Logs for support, and Windows settings that can slow Mailman down. These settings are on your computer only. See Contact support and send logs.
| Setting | What it does | Default |
|---|---|---|
| Send logs to support | Sends your logs with an optional note. | — |
| Export logs… | Saves a copy of your logs. | — |
| Open logs folder | Opens the folder that holds them. | — |
| Add exclusion | Excludes Mailman from Microsoft Defender scans. Windows asks for administrator permission. | Not excluded |
General#
Mailman account#
Your Mailman license and this computer. It is separate from the email accounts you add.
| Setting | What it does | Default |
|---|---|---|
| Signed in as, Email, Plan | Who you are and your plan. | — |
| Manage computers | Opens your account page to see or deactivate computers. | — |
| Join Discord | Joins the Mailman Discord. After joining, the row shows Open Discord. | Not joined |
| Sign out | This computer stops syncing and sending until you sign in again. | — |
About & updates#
Updates download in the background and install when you restart or quit.
| Setting | What it does | Default |
|---|---|---|
| Current version | The Mailman version on this computer. The web inbox also shows its own version. | — |
| Check for updates | Looks for a newer release. | — |
| What's new | Notes for the installed version. All versions are in What's new. | — |