Help menu Organize & automate
Collect information from emails
Pull codes, order numbers or links out of synced mail into a list you can export.
An extractor is a saved recipe that pulls values, such as codes, order numbers or links, out of mail you have already synced. Each run gives you rows to copy or export.
Run your first extractor 5 min#
- Open Extractor in the left rail (under More on a phone), then select New extractor.
- Enter a name and select a preset: Presale code, Verification code, Order number, Links or Blank.
- Under "2. Which emails", pick accounts and a Received range. New extractors start at 7 days.
- The preview beside the form updates a moment after you stop typing. Compare the values with the real emails. Select Test to check right away.
- Select Save & run.
- Select Export, pick Lines, CSV or JSON, then select Copy or Save file.
The preview reads at most 2,000 emails, starting with your first accounts, and stops after 10 matches. Save & run checks them all. Opening an extractor does not start a preview.
What you can set#
| Section | Choices |
|---|---|
| 2. Which emails | All matching emails or Only these stacks (up to 100, from Pick stacks). Accounts: All, Groups or Specific. Received: Last 24h, 7 days, 30 days, All time or Custom (UTC dates). Include spam and other folders is on by default. |
| 3. Match emails where | Up to 10 filters. Pick From or Subject, then Includes, Excludes or Matches (regex), and a value. Or values adds alternatives. All required filters must match. If every filter is Optional, any one is enough. |
| 4. Fields to extract | Up to 10 fields with unique names of 1 to 64 characters. The names account, alias, from, fromName, subject, date and messageId are taken. |
| 5. Options | Skip emails where nothing was found is on by default. Stop after N rows (0 = no cap) accepts up to 100,000. |
Select Pick from an email, then point at the value you want in a real message. Re-pick changes a field later. To take one part of an address, such as the street or city, drag across that whole line or that whole comma-separated part. For several parts, such as everything after the name, drag from the first part to the last. Mailman then takes the same part from each email, whatever the address. This works when the address follows a label such as "Ship to" or "Shipping address:". When the value moves around between emails, so the picker's own methods miss some of them, Mailman has AI write a method that fits every email it checked, and the result says so. To write it, Mailman sends the value you picked and the subject and text of up to seven of those emails to the AI. The method then runs on your computer, so extracting sends nothing more. Or set a method yourself:
| Method | Use it when | You enter |
|---|---|---|
| Text after… | A label comes first, such as "Your presale code" | The label and a Value shape, such as code, digits, URL or money |
| Pattern (regex) | The value has a recognizable shape | A regular expression, or a quick pattern such as 6-digit code |
| HTML element | The value sits in a link or element | A CSS or XPath selector, and a formatter: text, link, html or numeric |
Export#
| Format | What you get |
|---|---|
| Lines | One line per record from a template such as {account}:{code}. One line per value splits fields that found several values. Remove duplicates drops repeats. |
| CSV | A header row of account, alias, from, subject and date, then your fields. Opens in Excel. Cells starting with =, +, - or @ get a leading ' so spreadsheets don't run them. |
| JSON | A list of objects with account, alias, from, fromName, subject, date, messageId and your fields. |
Placeholders are {account}, {alias}, {from}, {fromName}, {subject}, {date} (UTC), {messageId} and your field names. {alias} is the address the mail was sent to, or the account address when they match. Use {{ and }} for literal braces. Save file saves on your computer and offers Show in folder. In a browser it downloads instead.
Runs and fixes#
Mailman keeps the newest 20 runs of each extractor. Pick another run from the list above the counts. Select a value to copy it. Right-click a row (press and hold on a phone) for Copy row or Open email. Copy row copies a tab-separated line in table order, with the same spreadsheet formula protection as CSV. On phones, Open email fills the screen and replaces the bottom tabs with email actions. Use Back to return to results.
- Cancel stops a run and keeps the rows found so far.
- Retry failed tries only the emails whose body could not be read. Select "failed" in the counts to see why.
- Delete run removes a run and its rows. Export first.
- If you see "No rows found", widen the date range or loosen a filter.
- "Choose at most 100 stacks" means remove some. "Choose at least one group" means pick a group or switch to All. "Could not show these results" comes with a reason; select Retry.
Clearing finished extraction runs from Activity keeps them hidden after a reload, including older runs loaded from an extractor?s history. Mailman remembers up to 200 cleared jobs on this device.
Share a recipe#
Select the ••• menu on an extractor, then Share…, then Copy or Save file to get a .mailman-extractor.json template. It leaves out accounts, groups, stacks and results, so whoever imports it chooses their own.
To use one, select Import… beside New extractor. Paste the template or select a JSON file (up to 256 KB), then select Review extractor. Nothing is saved until you select Save or Save & run. A name already in use gets "(2)" added. Templates are version 1; a newer one needs a Mailman update.