Help menu Reference

Settings reference

Every Settings section, its controls and their starting values.

Works in: App, web inbox & phoneUpdated 2026-11-20

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.

SettingWhat it doesDefault
Sync accounts automaticallyRe-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 opensSyncs 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 proxyAfter 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
Sync settings with automatic checks and proxy retry
The Sync section. Demo values, not defaults.

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.

SettingWhat it doesDefault
Connections at onceOpen connections across all accounts.1,000 (1 to 5,000)
Check every accountSeconds between passes over an account. Shown only when automatic sync is on.900 (60 to 86,400)
Automatic sync minimum intervalSeconds between automatic syncs of the same account.60 (30 to 3,600)
Per-proxy connectionsConnections at once through one proxy.4 (1 to 50)
Per-provider connectionsDefault cap for every provider.200 (1 to 5,000)
Provider overridesA 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.

SettingWhat it doesDefault
Enable Tasks APITurns the connection on or off at once. The status reads "Connected", "Connecting…", "Disconnected" or "Tasks API off". Change it on your computer.Off
API keySelect Copy to paste it into your tools. Regenerate stops the old key. It stays on your computer.Hidden
Maximum active inboxesUnder Advanced. How many inboxes Mailman watches at once; extra ones wait. Select Save task settings.200 (1 to 10,000)
Create templatePicks which inboxes a task watches. The ID can't change later, and edits apply to new tasks only.None
Developer toolsThe full test builder for selectors, regular expressions and formatters.—
Tasks API settings with the enable switch and masked key
Tasks API settings. Demo data.

Remote access & API#

Use Mailman from a browser, or let agents and scripts read mail and sync accounts.

SettingWhat it doesDefault
Open SharingIn the Read-only sharing card at the top. Opens the Sharing page, where you give someone else read-only mail.—
Remote accessUnder 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 APIREST and MCP on this computer, for tools you run here.Off
PortThe local API port. Select Apply after changing it.7357
Add clientCreates a token for one tool. Revoke ends its access.None
Create remote keyA 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 URLThe 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.

SettingWhat it doesDefault
Add destinationWhere alerts are posted: Discord or a webhook. Select Send test to check it.None
New ruleWhat to watch for: a sender or subject, tags, or order statuses. Pick destinations and accounts.None
Recent deliveriesThe last 50 alerts sent.—

Forwarding#

Mailman forwards matching new mail to other addresses while it's running. See Set up automatic forwarding.

SettingWhat it doesDefault
New ruleForwards mail from any listed sender whose subject has any listed keyword. Leave either empty to skip that filter.None
Include junkAlso 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.

SettingWhat it doesDefault
Choose automaticallyMailman picks how many browsers run at once for this computer.On
Browsers at onceThe 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 browsersWhen 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 overrideA proxy for browser sign-in only. Leave it blank to use each account's own proxy.Blank
Sign-in fallback proxy listUsed 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.

SettingWhat it doesDefault
Ask before deletingAsks 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 mailChoose 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 stackingStacks 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 stackingAlso stacks subjects that share a phrase of four or more words. Needs smart stacking.Off
Show imagesLoads 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.

SettingWhat it doesDefault
Check carrier websites for delivery statusOpens 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 listWhen 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 updatesQuietly 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 ordersOrders you hid are left out of Orders, its totals and CSV exports. Select View list, then Unhide.None
Blocked retailersEvery order from a blocked retailer is left out, including new ones. Select View list, then Unblock.None
Orders hidden by address or aliasEvery 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.

SettingWhat it doesDefault
Enable AI classificationTurns 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
ReclassifyClassifies stacks with mail in the range you pick again. Tags you set and sender rules are kept.—
Recent tag correctionsYour 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.

SettingWhat it doesDefault
New tagCreates a tag. You can have up to 250.None
Automatic taggingPer 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.

SettingWhat it doesDefault
New ruleStack together, tag, mark as spam, hide, move to a view, mark as read, or never spam.None
Sender rules and muted sendersOpen 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.

SettingWhat it doesDefault
Include mailAdds your mail to the backup. Without it, mail downloads again on the new computer.Off
PassphraseAt least 12 characters. Mailman doesn't store it, so a lost passphrase can't be recovered.Blank
Export backupSaves 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.

SettingWhat it doesDefault
Send logs to supportSends your logs with an optional note.—
Export logs…Saves a copy of your logs.—
Open logs folderOpens the folder that holds them.—
Add exclusionExcludes 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.

SettingWhat it doesDefault
Signed in as, Email, PlanWho you are and your plan.—
Manage computersOpens your account page to see or deactivate computers.—
Join DiscordJoins the Mailman Discord. After joining, the row shows Open Discord.Not joined
Sign outThis computer stops syncing and sending until you sign in again.—

About & updates#

Updates download in the background and install when you restart or quit.

SettingWhat it doesDefault
Current versionThe Mailman version on this computer. The web inbox also shows its own version.—
Check for updatesLooks for a newer release.—
What's newNotes for the installed version. All versions are in What's new.—

What's next