The Mail window shows the e-mails your local sites send. WebDonkey catches them with Mailpit, a mailbox on your Mac, so no test mail reaches real recipients. With Premium you also see your mailboxes on servers that you set up in WebDonkey. A mail opens as a tab in the editor area.
What you do here
- Read, search and delete your sites' test mails: Local mailbox.
- Read along in mailboxes on servers: Remote mailboxes.
- What you get without Premium: Without Premium.
How to open it
The window has no fixed shortcut. Open it through its icon in the right stripe or in the command palette (⌘K) with Show mail window or Show/hide Mail.
Layout of the window
| Area | What is there |
|---|---|
| Top bar | The search field Search mail (for the local mailbox), Refresh, Delete all and Open Mailpit in the browser. |
| Local mailbox | The row Mailpit with the number of unread mails, the mails below it. Clicking Mailpit folds the list in and out. |
| Remote mailboxes | One row per mailbox with name and user, foldable. Only when there are any. |
Clicking a mail opens it in the shared mail tab: the next mail you open from here replaces it, as long as it is still open. Open in its own tab (plus icon at the end of the row) or a double-click opens the mail next to it in a tab that is never replaced. That way two mails sit side by side.
Without WebDonkey
Mailpit is one of WebDonkey's local services. Without WebDonkey on this Mac the window only shows a hint. If WebDonkey is older than the editor needs, it asks you to update WebDonkey.
Free and Premium
The embedded mailbox is part of Premium, and so are the remote mailboxes. On Free the window shows a hint and Open Mailpit in the browser, and Mailpit itself works there as usual. Prices are on webdonkey.io/pricing.
If you don't need the window, hide it under Settings › Features › Tool windows.
Local mailbox Premium
Under Local mailbox are the mails your sites sent through WebDonkey's Mailpit: order confirmations, password mails, contact forms. You read them as a tab next to your code, see HTML, text and headers, and clean the mailbox up when it fills.
Where to find it
Mail window (icon in the right stripe or Show mail window in the command palette), section Local mailbox, row Mailpit. The list starts unfolded.
How to do it
- Open the Mail window. New mails show up by themselves, the window reads again every 5 seconds while it is open. Refresh reads right away.
- Each row shows sender, time (for older mails the date), subject, and a paper clip for attachments. Unread mails have a dot and bold text. Next to Mailpit it says "n unread". The newest 100 mails are shown.
- Click a mail. It opens in the shared mail tab and counts as read. A double-click or Open in its own tab opens it in a tab of its own.
- To search, type into Search mail. The list only shows matching mails. If none match, it says "No matching mail".
Read a mail
The tab shows the subject at the top (or "(no subject)"), From, To, Cc if there is one, and Date. Below that you pick the view:
| View | Contents |
|---|---|
| HTML | The mail as a mail program shows it. Remote images are blocked, next to it it says for example "2 remote images blocked". |
| Text | The mail's text part. |
| Headers | All header lines, for checking sender or spam markers for example. |
If a mail has no HTML or no text part, that view is locked. Attachments are listed on the right by name.
Clean up
Delete all (trash can at the top) asks "Delete all mails?" with the number of mails in the local mailbox. Delete empties the mailbox. When it is empty, the button is grey.
Open Mailpit in the browser shows Mailpit's own interface in the browser.
What happens in the background
- The window queries Mailpit on your Mac while it is open. Nothing goes to the internet.
- HTML mails run shielded: no scripts, no forms, no pop-ups, no images from the network.
- The editor marks an opened mail as read in Mailpit.
Free and Premium
The embedded mailbox is part of Premium. Without Premium see Without Premium.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| "Mailpit is not running" with the hint about Services | The Mailpit service is stopped | Start Mailpit in WebDonkey under Services or in the WebDonkey window. |
| "No mail yet. Everything your sites send lands here." | Your site has not sent anything yet | Trigger a mail, submit a contact form for example. |
| A red message below Mailpit | Mailpit reported an error | Restart Mailpit. |
See also
Remote mailboxes Premium
Under Remote mailboxes are the mailboxes you set up in WebDonkey, your shop's info@ or orders@ for example. You read their mails in the editor without opening a mail program. Sending, moving or deleting does not happen here, the mailboxes are read-only. They are part of Premium.
Where to find it
Mail window, section Remote mailboxes below the local mailbox. The section shows up as soon as there is at least one mailbox in WebDonkey. Above it sits the notice for working on servers.
How to do it
- Click a mailbox. It unfolds, and the editor loads its inbox.
- Each row shows sender, time or date, subject, a paper clip for attachments and a dot for unread mails.
- Click a mail to read it in the shared mail tab. A double-click or Open in its own tab opens it in a tab of its own.
- The mail has the same views as in the local mailbox: HTML, Text and Headers, with remote images blocked.
The editor remembers which mailboxes are unfolded and loads them again next time. A mailbox loads its inbox once when it unfolds. To reload, fold it and unfold it again.
Set up a mailbox
You create mailboxes in WebDonkey, under Remote › Mail. The editor takes them from there, see Set up a mail account in WebDonkey.
What happens in the background
The editor fetches the mails with WebDonkey's credentials straight from the mail server, only when you unfold a mailbox or open a mail. You are working directly on the server. The notice above the list reminds you: check the target and keep current backups at hand.
Free and Premium
Remote mailboxes are part of Premium. Without Premium they do not show up.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| A red message below the mailbox | Login or connection to the mail server failed | Check the credentials in WebDonkey. |
| The section is missing | No mailbox set up in WebDonkey, or no Premium | Create a mailbox in WebDonkey. |
| A new mail is missing | The inbox was loaded when it unfolded | Fold the mailbox and unfold it again. |
See also
Without Premium Free
Without Premium the Mail window shows no mails, but a hint: "The embedded mailbox is part of WebDonkey Premium. Mailpit itself works in the browser." Mailpit still catches your sites' mails. You read them in Mailpit's own interface in the browser.
How to do it
- Open the Mail window.
- Click Open Mailpit in the browser. Mailpit opens in the browser with all your sites' mails.
- If Mailpit is not running, start the service in WebDonkey under Services or in the WebDonkey window.
What Premium adds
- The local mailbox as a window next to your code, mails as tabs, search and Delete all in the editor: Local mailbox.
- Your mailboxes on servers to read along: Remote mailboxes.
Prices are on webdonkey.io/pricing.