# Email

Source: https://bulwarkmail.org/docs/features/email
Last updated: 2026-11-17

> How Bulwark handles reading, composing, searching, and filtering mail.

The mail client talks JMAP. Threading, search and flag changes are all resolved on the server, and the browser hears about the result rather than going looking for it.

![Bulwark mail reading view](https://bulwarkmail.org/_img/light-viewer.b63e449d25.1280.webp)

## Inbox and folders

![The Bulwark inbox with tagged messages](https://bulwarkmail.org/_img/light-inbox.e8c0fe3225.1280.webp)

Pick one of three layouts, per user, in settings: **split** (three panes), **focused list**, or **reading pane at bottom**. Any open message can also go fullscreen, and dragging a message from the list onto a new browser tab opens it there on its own. The mailbox tree shows unread counts, filters down to unread only, and accepts messages dragged into it. A unified view merges the inboxes of the active account, its shared mailboxes and the folders shared with it into one list, and an admin can allow it to span every connected account.

Long mailboxes are virtualised and paginate as you scroll, and the first page of message data is prefetched at login so the inbox isn't empty while you wait. Rows show their attachments, and an attachment opens straight from the row without opening the message first.

The order of the list is yours to set. Presets put unread, starred or tagged mail first; or define up to three custom sort levels. The order is applied through the JMAP sort, so the whole folder obeys it rather than the page you have loaded, and it can apply to the Inbox only or to every folder.

Folders can be shared with other users on the same server (`mail:share`). On Stalwart 1.0, picking whom to share with needs directory queries, which an administrator turns on with **Allow Directory Queries** under **Settings > Files & Sharing > Sharing**. When someone shares a folder with you, a toast says so and the folder appears under their account in your sidebar. Deleting a folder that still holds mail offers to delete the messages with it.

The rest is the ordinary furniture:

- Archive into a single folder, into year folders, or into year/month folders
- Empty Junk and Trash, with a confirmation first. When your organisation set it up, a line in Trash and Junk says how long mail stays there before the server deletes it ([retention notice](https://bulwarkmail.org/docs/guides/organisation/announcements.md#how-long-trash-and-junk-keep-mail))
- Configurable hover quick-actions, and attachments shown next to the sender or below the message header
- Answered and forwarded status icons in the list
- Right-click a folder to manage it, to import mail into it or to export it; the context menu header elides a long path in the middle rather than truncating it

## Shared mailboxes

A shared mailbox is a Stalwart group with its own address, such as `support@example.com`. Every member of the group sees its folders in the sidebar under **Shared**, next to their own. There is nothing to set up in Bulwark: the admin creates the group and adds its members in Stalwart. A folder that one person shares with another is different; it shows under that person's account.

![The Support shared mailbox open under Shared in the sidebar, with the team's mail in the list](https://bulwarkmail.org/_img/light-shared-mailbox.97c56b28f2.1280.webp)

Members read, move, archive and tag mail there as in their own mailbox; the Move menus list the shared mailbox's folders first and the member's own folders after them. Stalwart keeps one read state for the whole group, so when one member opens a message, it is read for everyone.

With several shared mailboxes the sidebar gets long. Turn on **Compact shared mailboxes** in Settings > Account > Multiple accounts to show each one as a single row: it opens the shared mailbox's inbox and shows its counts, and its folders hang below it, leaving out Drafts, Scheduled, Junk and Trash while they are empty. Your own mailbox stays as it is. To change the order of the shared accounts, drag them in the sidebar, or use **Move up** and **Move down** in an account's menu. A newly shared account goes to the end.

Replies can go out from the group's address. Stalwart lists that address among each member's identities, so pick it in **From**, or turn on "Reply from the address it was sent to" in Settings > Composing. Since Bulwark 1.19.1 such a message is sent through the group's own identity, so the server also takes the envelope sender from the group and not from one of your own addresses. A draft written as the group is saved in the group's Drafts, and the sent copy goes to the group's Sent folder.

![The composer replying to a message in the Support mailbox, sending from support@ in the From field](https://bulwarkmail.org/_img/light-shared-mailbox-reply.f705070257.1280.webp)

For teams that answer a shared mailbox together:

- Assigning a message to a member and marking it done comes from the [team inbox](https://bulwarkmail.org/docs/guides/organisation/team-inbox.md) plugin. It is coming to the extension directory; until then an admin uploads its ZIP. Plugins need Bulwark (not Lite).
- The same tag names and colours for every member ([shared tags](https://bulwarkmail.org/docs/guides/organisation/shared-tags.md)) and team templates ([templates](https://bulwarkmail.org/docs/guides/organisation/templates.md#team-templates)) need Stalwart 1.0.

## Composing

![The composer with an @mention chip and the contact card it opens](https://bulwarkmail.org/_img/light-composer-mention.296cfe0f23.1280.webp)

The editor is Tiptap: bold, italic, underline, strikethrough, ordered and unordered lists, links, tables, block quotes, and code blocks. Images can be pasted or dragged in. They go out as inline images in the message, not as separate attachments, and each one can be resized in place. There is a plain-text mode for people who want one.

With "Reply from the address it was sent to" turned on in Settings > Composing, a reply picks the identity the original was addressed to, either by exact address or, with "Any address on my domains", any address on your domains. On a catch-all domain that reply then comes back from the alias even though no identity exists for it. The From header can also be overridden by hand. Each identity has its own signature, and one setting decides whether signatures go before or after the quoted text.

On a reply, the quoted original stays in an editable block that preserves its own layout, so you can trim or annotate it without the formatting collapsing.

Before a message goes out, Bulwark checks the body for words like "attached" and warns you if nothing is attached. Turn on "Undo send / send delay" in Settings > Composing to hold each message for 10 to 60 seconds so you can take it back, or schedule a message for a specific time; both need a server with delayed sending. Read receipts (MDN, RFC 8098) can be requested here and are answered in the viewer. If the server supports them, the composer's Options menu can also request a delivery status notification (DSN) or mark the message REQUIRETLS, so the server refuses to hand it on over an unencrypted hop.

> **Note.** Stalwart 1.0 limits how many submission records, one per sent message, an account may keep: 500 by default. Bulwark 1.18.0 and newer deletes the records of sent and cancelled messages, including those other clients left behind; a scheduled message keeps its record until it goes out. If an account still reaches the limit, an administrator can raise it with **Submissions** under **Settings > Email > Defaults**. Older Bulwark releases never delete their records and stop sending at the limit.

Replying to someone adds them to your trusted senders, so their images load next time without asking.

When your organisation uses [classification labels](https://bulwarkmail.org/docs/guides/organisation/classification-labels.md), the subject line has a label chip, such as Internal or Confidential. A reply or forward starts with the original's label. If a label is required, Send asks for one first. The label goes into the message's headers, and its prefix in front of the subject.

Press `c` in Mail to open the composer. [Composing emails](https://bulwarkmail.org/docs/features/email/composing.md) goes through all of it.

## Reading

![A message in Spam whose sender failed the receiving server's checks, with the warning above the body](https://bulwarkmail.org/_img/light-sender-check.4f68f232eb.1280.webp)

Messages render in an iframe, sanitised by DOMPurify on the way in. In dark mode the HTML is recolored by luminance so a white newsletter doesn't blind you, while emoji keep their own colors. Mail that survives this badly can be forced to light mode, either per message or globally, and any message with both parts can be flipped between its HTML and plain-text version from the viewer toolbar.

External content is blocked until you trust the sender, and the banner saying so sits above the attachments rather than below them. Next to it, SPF, DKIM and DMARC results are shown with the most severe SPF outcome surfaced first; on spoofed mail the "via" badge is suppressed rather than lending the message credibility. Only the Authentication-Results your own Stalwart wrote when it received the mail count, and those of the [mail servers your administrator trusts](https://bulwarkmail.org/docs/getting-started/configuration/environment-reference.md#trusted_authserv_ids), such as a filtering gateway or Gmail. Mail from any other server, such as mail synced in over IMAP, shows no verdict: no warning and no pass. Imported mail never gets one.

TNEF (`winmail.dat`) bodies and attachments from Outlook are unpacked, and an embedded `message/rfc822` attachment is unwrapped and rendered as the email it is, after its HTML has been validated.

When your organisation set up [phishing reports](https://bulwarkmail.org/docs/guides/organisation/phishing-reports.md), **Report phishing…** in the message menus sends a suspicious message to your security team and moves it to Junk. It asks first and names the address. A reported message shows a banner and its links are turned off. Mail with a classification label of your organisation shows the label next to the sender. If your organisation checks links before they open or messages before they go out, [Link and send checks](https://bulwarkmail.org/docs/features/email/organisation-checks.md) explains the dialogs.

Booking, shipping and order mail that carries schema.org markup gets a card above the message: route and times for flights and trains, check-in and check-out for hotels, tracking for parcels, status for orders, with an Add to calendar button where it fits. See [Booking and parcel cards](https://bulwarkmail.org/docs/features/email/booking-cards.md).

Attachments can be downloaded, previewed inline, or dragged straight out to the desktop. Images preview as thumbnails, PDFs open in the browser's PDF viewer on desktop and are drawn page by page on phones, and `.eml` attachments open like mail.

Your organisation can [turn some of this off](https://bulwarkmail.org/docs/guides/organisation/device-policies.md). With downloads off, attachments only preview: the reader says "Downloads are turned off by your organisation", a file that can't be previewed doesn't open, and PDFs are always drawn page by page. With export or printing off, Export as .eml, View source or Print are gone from the menus, and printing the page with Ctrl+P gives a page that says printing is off. A faint watermark with your address and the date can lie over messages, previews and printouts. In a unified inbox each message follows the settings of its own account.

Around all of that: reply, reply-all and forward, a quick reply form under the message (Settings can turn it off), expandable headers with a contact sidebar, move-to-mailbox, one-click unsubscribe (RFC 2369), printing, and a bottom action bar on mobile. The reader shows when the mail arrived, as the message list does; the date the sender gave is under **Sent** in the details. Sender avatars show the contact's photo if you have one, otherwise the sender's BIMI logo or the website icon of the sender's domain, and initials when there is none of these.

> **Note.** In Bulwark Lite, BIMI logos and website icons are off, since both are fetched by the Node.js server, which Lite doesn't have. Contact photos still show.

## Search

![Search results across folders, each row showing the folder it came from](https://bulwarkmail.org/_img/light-search.2d65d95d8a.1280.webp)

The advanced panel builds the query from fields (text, from, to, subject, body, has-attachment, message size, date before and after, read status, starred) and each one you fill in becomes a removable chip above the message list. Matching text in the results is highlighted with the server's own snippets.

Queries run across all folders except Spam and Trash by default, not just the folder you're standing in; "Search in" picks all folders or one folder. Every filter you fill in must match. With Stalwart 1.0's built-in search index, a quoted phrase matches exactly, and `word*` finds words that start with `word` as long as that part is at most 16 bytes long. Bulwark 1.18.0 and newer sends each quoted phrase and each `word*` as a condition of its own. Press `/` to jump to the search bar. Beyond mail, "Search everything" searches contacts, calendar events and files too, across every account: open it from the command palette (Ctrl/Cmd+K), or in the Pro interface with Ctrl/Cmd+K or the search button on the rail. [Search and filters](https://bulwarkmail.org/docs/features/email/search.md) covers both.

## Labels and tags

![The Travel tag selected in the sidebar, with the tagged messages listed](https://bulwarkmail.org/_img/light-tag.7aca52c99a.1280.webp)

Colored labels map onto JMAP keywords, so they follow the message into any other client that reads the same account. Names and colors are set in Settings > Folders & tags, where a tag can also take any color from a color code or the color dialog, tags can nest under a parent once "Nested tags" is on, and each one can be always shown, shown only while it has unread mail, or hidden. The tag view lists tagged mail from your account and from the shared mailboxes and shared folders you can see, leaving out Trash and Spam.

## Time zone

Dates and times follow the browser's zone unless you pick one in settings, which is the setting for people who read mail from a machine that thinks it is somewhere else.

## Export and import

Import mail from `.eml`, ZIP, mbox and Outlook `.pst` files, and save a folder or your whole account as mbox or a ZIP of `.eml` files. Large imports pause at the server's upload limit and continue by themselves, and a stopped import continues where it left off. See [Import and export mail](https://bulwarkmail.org/docs/features/email/import-export.md).

## Batch operations

Select several messages and archive, delete, move, tag, mark read or unread, or report them as spam in one action.

## S/MIME

S/MIME comes from the S/MIME plugin in the extension directory, which an administrator installs. It isn't available in Bulwark Lite, which has no plugins. With the plugin installed, you import PKCS#12 identities and recipient certificates under Settings > Add-ons, bind a certificate to an identity so signing defaults on for it, and toggle signing and encryption per message in the composer's Options menu. Incoming mail decrypts automatically when the matching key is loaded, signatures are verified in the viewer, and the signer's certificate can be auto-imported so you can encrypt the reply. Older bundles using password-based encryption are supported too.

The full write-up, including the algorithm table and what each banner means, is on the [S/MIME page](https://bulwarkmail.org/docs/guides/smime.md).

## Filters

![The filter settings with the active Sieve rules](https://bulwarkmail.org/_img/light-filters.82b6a8dc71.1280.webp)

Filtering happens on the server, as Sieve scripts over JMAP (RFC 9661), which means it keeps working while the browser is closed.

Build rules visually (From, To, Cc, Delivered to, Subject, Size, Body, Attachment, and so on, most of them matching against several values) with actions to move, forward, mark read, star, discard, or reject. Reorder them by dragging. An expanded view shows every rule at once for review, and if you'd rather write Sieve directly there's a raw editor with syntax validation. Edits save themselves and roll back if the server rejects the script.

The rule dialog reads as a sentence: "If all (or any) of these conditions apply", then a list of actions to tick. While you type the conditions, it counts the mail the rule already matches. Click the count to see the messages.

A rule on your own account can also act on that mail. **Apply to** offers **New mail only**, new mail and the Inbox (or the folder of the message you made the rule from), or **New mail and all mail**. On mail that is already there:

- Mail in Sent, Drafts, Trash and Spam is left out.
- Forward and reject do nothing.
- Discard moves the mail to Trash, after a question that says how many messages go there.
- Rules that check the body, Delivered to or a regular expression don't run. They act on new mail only.

**Delivered to** matches the address the server delivers the mail to, which the To or Cc header doesn't have to name: Bcc copies, mailing lists, aliases. Delivered mail doesn't keep that address, so these rules show no count and work on new mail only.

To run a saved rule on a folder later, right-click the folder, open **Rules** and pick the rule. It works like Apply to, on that folder. Rules that can only act on new mail are greyed out.

The whole section only appears when the server advertises Sieve support.

## Vacation responder

![Out of office settings with a date range and the auto-reply text](https://bulwarkmail.org/_img/light-vacation.400f265b60.1280.webp)

Out-of-office replies are a JMAP `VacationResponse`, which the server runs for you, so it keeps answering while nothing of yours is running.

Set a subject and a plain-text body, and optionally a start and end date; leave either empty for no limit at that end. The dates are in the time zone you picked in settings, or the browser's when you picked none. If your organisation wrote reply templates, **Use a template** fills one in with your name, the dates and, when the text names one, a colleague's address you type first; you can change the text afterwards ([out-of-office templates](https://bulwarkmail.org/docs/guides/organisation/out-of-office.md#reply-templates)). Turning on **Formatted message (HTML)** adds an HTML version written in the same rich-text editor as the composer, and recipients whose client won't render it fall back to the plain text. A preview shows what goes out before you save.

This needs a server that supports VacationResponse; forwarding and replying only to internal or external senders also need Sieve. On Stalwart 1.0 the replies go out with an empty envelope sender (<code style="font-variant-ligatures: none">MAIL FROM:&lt;&gt;</code>), as RFC 5230 recommends.

## Templates

![The template settings](https://bulwarkmail.org/_img/light-settings-templates.c232b22a04.1280.webp)

Templates are reusable messages, each with a category you name yourself. Placeholders such as `{{date}}` and `{{sender_name}}` fill themselves in; `{{recipient_name}}`, `{{company}}` and your own placeholders are asked for when you insert the template. Write `{{name:default}}` to start a field with a value.

In the composer, press `t` (outside a text field) or use Templates > Insert template to open the picker, which searches your templates and groups them by category. Create and edit them under Settings > Composing > Email templates.

## Next step

[Composing emails](https://bulwarkmail.org/docs/features/email/composing.md) covers the editor, identities, signatures and attachments in detail.
