Navigating and Searching Messages¶
This page documents the message list — the MessageTree widget that fills
the main window and shows the messages in the current folder. It covers how the
list is organized, how to move through and open messages, the actions available
on a selection, and how the search bar filters what you see.
How the list is organized¶
The message list is a tree view. Depending on the folder and your preferences it renders in one of several modes:
| Mode | What it shows |
|---|---|
| Threaded | Replies are nested under the message they answer, so a conversation appears as an expandable tree. |
| Flat | One row per message, with no nesting. |
| Mode | What it shows |
|---|---|
| Multi-column | Separate columns (sender, subject, date, size, …). |
| Simple (single-column) | A compact one-column layout combining the key fields. |
When a search spans more than one folder, a Folder column is added so you can see where each result lives.
Per-folder layout
Column visibility, widths, and sort order are remembered per folder (and per view mode), so each folder keeps the layout you last gave it.
Sorting¶
Click a column header to sort by that column; click again to reverse the order. The date and size columns resize to their contents when you sort by them. The current sort column and direction are kept in sync with the sort controls and saved with the folder's layout.
Moving through the list¶
Standard list navigation applies, with a few message-specific behaviours:
| Key | Action |
|---|---|
| Up / Down | Move to the previous / next message |
| Page Up / Page Down | Move a page at a time |
| Home / End | Jump to the first / last message |
| Right | Expand the current conversation (when it has nested replies) |
| Left | Collapse the current conversation |
| Shift+Up / Shift+Down / Shift+Page Up / Shift+Page Down | Extend the selection |
| Ctrl+A | Select all messages |
Selection always operates on whole rows, and you can select several messages at once to act on them together.
Where the selection goes after a change¶
When the list reloads — after you delete, move, or receive messages, or when a background sync changes the folder — the view does its best to keep you on a sensible message rather than jumping to the top:
- If the message you were on still exists, it stays selected.
- If it was removed (deleted or moved away), the view selects the nearest surviving neighbour — the next message down, or the previous one if you were at the end.
- Your previous multi-selection and scroll position are restored where possible.
This means you can delete or file a run of messages without losing your place in the list.
Opening a message¶
How a message opens depends on the folder and the modifier keys:
| Gesture | Result |
|---|---|
| Enter or double-click | Open in a new tab |
| Ctrl+Enter or Ctrl + double-click | Open in a new window |
| Gesture | Result |
|---|---|
| Enter or double-click | Open in the message editor for continued editing |
| Ctrl + double-click | Open in a new tab (read-only view) |
| Ctrl+Shift + double-click | Open in a new window |
Acting on a selection¶
Right-click (or press the menu key) to open the context menu. The menu adapts to the current folder and selection; entries that do not apply are hidden.
Reply, forward, and re-use¶
| Action | Notes |
|---|---|
| Reply | Reply to the sender. |
| Reply to All | Reply to the sender and all recipients. |
| Forward | Forward the message to new recipients. |
| New Using ▸ Same Recipients and Content | Start a new message pre-filled from this one. |
| New Using ▸ Same Recipients | Start a new message to the same recipients. |
Open, organize, and flag¶
| Action | Notes |
|---|---|
| Open in New Tab / Open in New Window | Same as the keyboard/mouse gestures above. |
| Show MIME Source (Ctrl+U) | View the raw message source. (Standard-protocol builds only.) |
| Mark as Read / Mark as Unread | Only the applicable entry is shown, based on the current read state. For a collapsed conversation, the state of its unread replies is taken into account. |
| Save As… / Export (Ctrl+S) | Save the message to a file. |
| Download body and attachments | Fetch the full message content for offline use. |
| Move ▸ | Move the selected message(s) — and any nested replies — to another folder. |
| Copy ▸ | Copy the selection to another folder. |
| Flag Message ▸ | Apply a colour flag. |
You can also drag a selection from the list onto a folder to move it. (Drag is disabled in the Junk folder.)
Outbox: retrying and cancelling¶
In the Outbox, messages that are waiting to send expose extra controls:
- Failed sends show a clickable status; clicking it (or the Retry Send context-menu entry) re-queues the message.
- Delayed sends (scheduled for a future time via timed delivery) offer Cancel Send in the context menu, so you can stop a message before its scheduled time.
Searching¶
Open the search bar with the Search toolbar button () or
Ctrl+K; hide it with Ctrl+Shift+K or the bar's Hide button. The
search bar filters the message list live as you type.
Search scope¶
Buttons in the search bar choose which fields are matched. They can be combined, and their defaults are:
| Toggle | Default | Matches against |
|---|---|---|
| Sender | On | The From address/name |
| Recipients | On | The To/Cc/Bcc addresses |
| Subject | On | The subject line |
| Body | Off | The full message text |
| All Folders | Off | When on, searches across folders instead of just the current one |
Body search loads more data
Subject, sender, and recipient searches run against data already in the local index. Turning on Body widens the search to full message text, which may pull in additional content as needed.
Search is per folder¶
Each folder remembers its own search state. Opening the search bar in one folder and switching to another leaves the first folder's query intact; returning to it restores what you had typed and which scope toggles were active. Closing the search bar clears that folder's query and returns it to the normal folder view.
Junk folder¶
The Junk folder applies its own spam-score filtering on top of any search. Searching with All Folders off keeps trash excluded; turning All Folders on widens the result set accordingly.
Keyboard shortcuts¶
| Shortcut | Action |
|---|---|
| Enter | Open (tab, or editor in Drafts) |
| Ctrl+Enter | Open in a new window |
| Ctrl+A | Select all |
| Shift + arrows | Extend selection |
| Right / Left | Expand / collapse a conversation |
| Ctrl+K | Show the search bar |
| Ctrl+Shift+K | Hide the search bar |
| Ctrl+S | Save As… / Export |
| Ctrl+U | Show MIME source (standard-protocol builds) |
Icon reference¶
Icons used around the message list and its actions:
| Function | Icon |
|---|---|
| Search | |
| Reply / Reply to All / Forward | rendered by IconRenderer ( |
| New Using… (edit as new) |