Guide
Postling, step by step
Setup takes about ten minutes: twelve short steps, each with sensible choices already filled in. After that Postling works on its own, and you check in when a briefing arrives. This guide walks through every step and every screen.
The screenshots show a made-up family, the Morgans: Alex, their children Emma and Leo at Hillside Primary, and a job search. Your screens show your own email, which never leaves your Mac.
Setting up
Step 1 of 12
Welcome
Open Postling and the setup window appears, with the twelve steps listed on the left. You can go back to any finished step by clicking it, and nothing changes in Gmail until you press Start Postling at the end.

Step 2 of 12
Connect Gmail
Click Connect Gmail. Google's own sign-in opens, so Postling never sees your password. Pick your account and allow access.
- Postling asks for one permission: to read, label and archive your email, and to send your briefing from your account. It never deletes anything.
- The permission is kept in your Mac's Keychain. Disconnecting in Settings also revokes it at Google.
- While Postling is in beta, Google may say it "hasn't verified this app". Choose Advanced → Go to Postling to continue.

Step 3 of 12
About you
Choose what this inbox is for. You can pick more than one, and each choice sets up focus areas and briefing times you can change later:
- Family: Kids, Health and Home. Each child gets their own label, and school dates can go in the family calendar.
- Personal: Job search, Opportunities and Plans.
- Professional: Clients, Invoices and Team.
Then add your name and a sentence or two about what matters to you, such as "Two children at Hillside Primary" or "I run a small design studio; clients come first". The AI on your Mac uses this to judge what needs you.

Step 4 of 12
Your inbox
Postling takes a quick look at your inbox to suggest a setup. It reads senders and subjects from the last 30 days, plus a few recent emails from schools and key contacts. This happens on your Mac and takes a minute or two.
- Found in your emails lists the people it found, such as each child with their school and year. Each gets their own label, like Kids/Emma, and their own section in your briefing.
- Your top senders shows who writes most and what their mail looks like. Senders marked ★ belong to a focus area.

Step 5 of 12
Your existing labels and rules
If you already use Gmail labels and filters, decide how Postling works with them. Nothing you've set up is deleted, renamed or changed.
- Use for: points one of Postling's categories or focus areas at your label, so no duplicate is created. In the example, the existing School label is used for Kids.
- Learn from it: Postling reads the emails you've filed in that label, on your Mac. New email goes where you've put similar emails, so the school's netball news goes to one child and the rugby news to the other, even from the same sender. Anyone you file there consistently is followed too. It also learns which kinds of email you act on (you replied or starred them) and which you only read, and sorts new ones the same way. It works for labels used by a category, focus area or person, and the status next to the switch shows how many emails it learned from. Learn now re-reads them straight away; otherwise Postling refreshes once a week.
- Your Gmail filters keep working. Postling explains how each one fits in, such as a filter that already files newsletters.

Step 6 of 12
Categories
Every email gets one category and the matching Gmail label. The list starts from what you already have:
- From your Gmail: your own labels from the previous step. The ones you use are already switched on, so Postling files email into them. Archive labels and empty ones start off.
- Recommended by Postling: suggestions such as Newsletters or Social. Postling creates the label the first time it files an email there.
- Added by you: anything else you'd like, with Add a category.
Under each category you can see what happens to it: "stays when it needs you", "only when urgent", or "labelled and archived". Click a category to change what belongs in it, or Remove it. Your Gmail labels themselves are never renamed or deleted.

Step 7 of 12
Focus areas
Focus areas are what matters most to you. They get their own labels, a higher priority and their own section at the top of your briefing. Your template and the inbox scan have already filled these in, so here you just check them.
Click an area to see how Postling recognises it, using sender domains and names. You can also make health and safety always high priority, or send that area's briefing to someone else, such as your partner for Kids. More on editing focus areas.

Step 8 of 12
Briefings
Choose when to catch up: up to three times a day. Each briefing covers what's new since the one before. Presets cover common routines, such as a morning and evening briefing for a family.
- How much detail: headlines only, one or two sentences, or detailed, which includes every date and amount so you rarely need to open the email.
- NEW / UPDATE / PENDING tags show at a glance what's arrived, what's changed and what's still waiting.
- Who gets it: your own address by default. Add others if you like.

Step 9 of 12
Calendar
Turn on Put dates from my email in my calendar and choose a calendar. Any calendar on your Mac works, including iCloud, Google and Exchange. Postling adds only things you need to do or attend, never marketing dates. Titles come from the email's own words.
- By label: send each area to its own calendar, such as school dates to the family calendar, the job search to yours and nothing from work.
- Remind me adds an alert a day before, or two days before deadlines.
- Attachments and letters: Postling can read PDF letters and photos of letters attached to important emails, and open letters linked from school platforms like SchoolPost, so their dates reach your calendar too.
- If a later email changes a date, the event moves.

Step 10 of 12
Inbox rules
Only email that needs you stays in your inbox. Everything else is labelled and, after a trial, archived. Nothing is ever deleted.
- Trial: for the first few days (3 by default) Postling only adds labels, so you can check its decisions before anything leaves your inbox.
- Keep it running: open Postling at login (recommended), and get a notification when something urgent arrives or a briefing is sent.
- Tidying: mark archived emails as read, star the most urgent, clear security alerts after 3 days, and check for new mail every 15 minutes.

Step 11 of 12
Privacy
Postling reads your email with Apple's on-device AI, so nothing about your email is sent to a server. A green note confirms it's ready.
Your data shows where everything is stored. From here you can disconnect your account or delete all local data at any time.

Step 12 of 12
You're all set
A summary of your choices: the trial, your briefing times and how often Postling checks your mail. Press Start Postling. It sorts your last 7 days of email, and your first briefing arrives at the next time you chose.

Every day
Today's briefing
Your briefing arrives by email at the times you chose. Today shows it in the app, and Send now sends one straight away. Three views sit above it:
- Now is the latest briefing minus what you've dealt with. Archive an email, mark it as not needing you or fix its category, and the briefing updates a moment later; anything you archive or answer in Gmail drops off at the next check. The line above the list counts what you've handled since it went out. New mail waits for the next briefing, so the list only gets shorter.
- As sent is the email exactly as it arrived.
- Next briefing is what the next one would say right now, new mail included.
- Top 3 are the most important things right now. Below them, each focus area and person has a section, such as Kids/Emma and Kids/Leo.
- P0 means it needs you today; P1 means soon. NEW, UPDATE and PENDING show what changed since the last briefing.
- With more than one account, a chip shows which account each item came from (here Personal or Work).
- In your calendar shows the dates Postling added. Double-click an item to read its email in the app.
Deal with several at once. In Now, each item's summary is often enough to decide. Click an item, then Shift-click or ⌘-click others (⌘A selects them all), and one action covers them all: Archive takes them out of your inbox, Read steps through them, and Correct changes their category or priority. Right-clicking an item offers the same actions. An item with several emails counts as all of them. Nothing is deleted, but there's no undo: an archived email stays in Gmail, where you can move it back to the inbox. If Gmail can't be reached, Postling says how many emails didn't move and keeps them selected to try again.
The email itself is a branded card that reads well on your phone. It starts with a summary of what's new, what's still pending and what went into your calendar, then your top 3 and a section for each area and person. Each item ends with Open in Gmail.


Review
Needs review lists the few decisions worth a second look, each with the reason, such as "from a person, but filed away" or "might be Kids". For each one:
- Change the category, priority or Inbox if something's wrong.
- Tick always to make a rule for that sender.
- Press ✓ if it looks right.
You can also correct Postling from Gmail, on any device: move an email to another label, back to the inbox, or star it. Postling learns from that on its next check. After you've moved three emails from the same sender, it offers to make a rule.

Activity
What Postling has been doing:
- Learning: the corrections it has learned from, including your moves in Gmail.
- In your calendar: every date it added, with a button to read the email and one to remove the event. A removed event is never added again.
- Last 7 days by label: how much arrived and how much was kept in your inbox.
- Runs: each check, with what was processed and archived.

More than one account
Connect a second Gmail account, such as work alongside personal, from Settings → Accounts → Add another Gmail account. Each account has its own settings: its own focus areas, categories, labels and rules, briefings and calendar. Everything is still in one place.

Setting up a new account. After Google's sign-in, Postling runs the same setup as for your first account: what the account is for, a quick look at its inbox, its own labels and rules, briefings and calendar. To save time, Copy settings from starts from an account you already have. The new account isn't sorted until you finish. If you stop part-way, Finish setup in Accounts takes you back.

One account, or all together. The account menu at the top left of the window switches between All accounts and a single account. Today, Review and Activity show what you pick, and the menu shows which one you're looking at.

Here, Today shows only the work account.

Briefings for each account. Each account can send its own briefing, at its own times and to its own recipients. Any account can also be included in the combined briefing, which goes out with your first account's at its times, with a chip on each item showing which account it came from. Settings pages show Settings for at the top, so you always know which account you're changing.

On your iPhone
The iPhone app lets you open the emails your briefing highlights and clear them while you're away from your Mac. It's being tested and isn't in the App Store yet: join the beta and we'll tell you when it's ready.
Setting it up. On your Mac, go to Settings → Engine & privacy and turn on Show my briefing in Postling for iPhone. It's off until you do. Then open the app on your iPhone and tap Connect Gmail. With several accounts, connect each one.
- Read. Tap an item to open its email. An item with several emails steps through them. Images stay blocked until you tap Load images.
- Clear. Swipe an item to archive it, or tap Select to archive several at once. Undo appears for a few seconds. Nothing is deleted, and your Mac picks up the change on its next check.
- One account or all. With more than one account, the menu at the top shows them together or one at a time.

How it stays private. Your Mac does the sorting and writes the summaries, then leaves them in a private message in your own Gmail, hidden from your inbox and never sent. Your iPhone signs in to Gmail and reads that message and your emails directly. Nothing passes through us. Each update moves the previous status message to Trash; Postling never trashes anything else.
When your Mac is asleep. You can still read and clear what's listed, but new mail isn't sorted until your Mac is awake. The app tells you if your Mac hasn't checked in for several hours.
Removing an account. Remove on the iPhone only forgets it on that phone; your Mac stays connected. Disconnect on the Mac revokes access at Google, which signs the iPhone out too.
Settings
Every setup step has its own page under Settings in the sidebar, so you can change anything at any time. With several accounts, choose whose settings you're changing at the top of the page.
Good to know
- Postling lives in the menu bar. Close the window and it keeps working. Use the menu to check mail or send a briefing now.
- Nothing is ever deleted. Postling labels, archives, marks as read and stars. Everything it archives is still in Gmail under its label.
- Correct it anywhere. Moving an email between labels in Gmail on your phone teaches Postling as well as Review does.
- It works while your Mac is awake. After sleep it catches up on its next check.
- Your email stays on your Mac, unless you add the iPhone app, which reads it directly from Gmail. Read how Postling handles your data.