# Command and Menu Reference

Each &kmail; specific menu item is discussed below. When there is a keyboard shortcut that performs a menu item function, the default shortcut is listed with the menu item.

## The &kmail; Reader Window

### File Menu

File New

- Here you can create several new items as follows:

File New New Message...

- Compose a new message.

File New Message from Template

- Creates a new message from a selected template. Please see Compose From Templates for additional information on creating templates.

  If you do not have any templates saved, you will see Message Message from Template(no templates).

File New Add Folder...

- Create a new folder.

File New New AddressBook Contact...

- Brings up the New Contact dialog.

&Ctrl;O File Open...

- Open email messages or mailboxes.

File Open Recent

- Opens recently used messages. Only messages that have been saved and then opened will show up on this list.

&Ctrl;S File Save As...

- Saves the currently displayed message to a `.mbox`. This includes all the headers and attachments.

  If you would like to save it to a different format ⪚ `.txt`, deselect Automatically select filename extension (.mbox), and be sure to change the file extension while naming the file.

File Import Messages...

- Starts up KMailCVT. This application lets you import messages from several email clients into &kmail;.

File Print Preview...

- Display a dialog which shows how your email will be printed.

  This will only be enabled if a printer has been configured and is online available for use.

&Ctrl;P File Print...

- Display a dialog that lets you print the currently displayed message.

File Expire All Folders

- Delete old messages from all folders. Deletion will occur according to the rules in each folder's Properties dialog (the default is not to delete old messages at all).

File Empty All Trash Folders

- Use this to empty all trash folders, &ie; the local trash folder and all trash folders that you might have on &imap; servers.

File Work Offline

- Sets &kmail; to offline mode. This turns off all network jobs. This is useful when working with messages without a network connection. This selection will become File Work Online, which needs to be selected to go back online (required to send and receive).

&Ctrl;L File Check Mail

- Checks for new messages in all your accounts.

File Check Mail In

- Check for new messages from a particular account, these accounts will be listed in the submenu.

F5 File Update Folder

- Checks whether new mail arrived in the currently selected folder.

  This is only available for &imap; folders.

&Ctrl;F5 File Update This Folder and All Its Subfolders

- Checks whether new mail arrived in the currently selected folder and all of its subfolders.

  You can also select multiple folders and the menu item will turn into File Update These Folders and All Their Subfolders

  This is only available for &imap; folders.

File Send Queued Messages

- Sends the messages that are in your outbox. Messages can end up in your outbox by selecting Queue in the composer menu, composing a message in offline mode, and sending while you have no Internet connection.

File Send Queued Messages Via

- Sends the messages that are in your outbox via a specific outgoing account. This allows you to choose which server to send your queued messages from. They must be configured in Configure &kmail; dialog, under the Accounts Sending tab to show up here.

&Ctrl;Q File Quit

- Exits &kmail;.

### Edit Menu

If the menu item you are looking for is missing, please see Edit Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

Del Edit Move to Trash

- Moves the selected messages to the trash folder. If the selected messages are already in the trash folder, they will be permanently deleted.

&Ctrl;Del Edit Move Thread to Trash

- Moves the selected thread to the trash folder, ⪚ a conversation in a mailing list.

S Edit Find Messages...

- Opens up a search window that lets you search for messages with certain characteristics, ⪚ a certain subject. Please see Filter Criteria for details on search options.

  Your search results will display in the text area, at which point you can open the Open Search Folder or highlight the desired message and select Open Message.

&Ctrl;F Edit Find in Message...

- Searches the current message text for a string entered into the Find: textbox.

&Ctrl;A Edit Select All Messages

- Selects all messages in the current folder.

&Ctrl;T Edit Select All Text

- Selects the text of the currently displayed message.

### View Menu

View Message List

- This menu has the following options to change the view of your message list.

  Sorting

- Contains options to customize your sort order as follows:

  - Message Sort Order has several options, most are self explanatory. The following options may not be immediately obvious, therefore deserve an explanation.

    - By Smart Sender/Receiver will display the sender when you are reading in your outbox folder/template folder, and display the receiver when you are in your inbox/inbox subfolders.

    - By Action Item Status and By Important Status need to be set before they can be sorted. Please see Mark Messages for more information on marking your messages.

  - Message Sort Direction and Group Sort Direction allow you to change the direction of your messages/groups sort respectively.

  - Folder always Uses this Sort Order allows you to keep your sort settings per folder.

Aggregation

- Allows you to set your aggregation view.

  Configure... Allows you to configure aggregation, please see Configure Appearance Message List for more information on aggregation.

Theme

- Allows you to select a theme.

  Configure... Allows you to configure themes, please see Configure Appearance Message List for more information on themes.

&Ctrl;&Shift;O Create New Tab

- Creates a new tab, then select the folder you would like to display in the tab.

&Ctrl;&Shift;W Close Tab

- Closes the currently selected tab.

View Headers

- Select your headers view. Please see Header Options for details on headers.

View Attachments

- Changes the way attachments appear in the Message Preview Pane (independent of the &MIME; Tree). Please see Attachment Options for details on attachments.

. View Expand Thread / Group

- This will display the thread of the current message, &ie; all messages that are replies to the current message.

, View Collapse Thread / Group

- This will hide the thread of the current message, &ie; it will hide all messages that are replies to the current message.

&Ctrl;. View Expand All Threads

- Expands all threads in the current folder.

&Ctrl;, View Collapse All Threads

- Collapses all threads in the current folder.

V View View Source

- Shows the message and its complete headers in plain text format in a new window. This can be useful to find out the origin of a mail.

  You should know that it is easy to fake the `From:` header of a mail, but one can still find out which mail servers have been used to send the message by looking at the `Received:` lines in the header.

View Show Message Structure

- Display the structure viewer, which is a part of the main window that lets you access all parts of a message.

X View Use Fixed Font

- Uses a fixed width (Monospace) font to display the messages in the current folder. The font to be used can be configured in the Fonts tab on the Appearance page of the &kmail; configuration dialog.

View Set Encoding

- Lets you choose the character encoding to be used in the Message Pane. The default, Auto, should work in almost all cases.

View Zoom

- Allows to zoom message in the Message Pane.

### Go Menu

J Go Jump to Folder...

- Show a dialog box with a list of all your folders. Click on the folder you wish to view and it will display it in the message view pane.

N Go Next Message

- Selects the next message in the message list. The keyboard shortcut Right Arrow also performs this action.

+ Go Next Unread Message

- Selects the next unread message in the message list. If there are not any unread messages below the currently selected message, then the behavior depends on the value of the configure-misc-folders-go-unread option.

P Go Previous Message

- Selects the previous message in the message list.

- Go Previous Unread Message

- Selects the previous unread message in the message list. If there is not an unread message above the currently selected message, then the behavior depends on the value of the configure-misc-folders-go-unread option.

&Alt;+ Go Next Unread Folder

- Jumps to the next folder with unread messages.

&Alt;- Go Previous Unread Folder

- Jumps to the previous folder with unread messages.

Space Go Next Unread Text

- Scrolls down if you are not yet at the bottom of a message, otherwise jumps to the next unread message.

### Folder Menu

Folder Add Folder...

- Opens the Folder Properties dialog that lets you create a new folder.

Folder Mark All Messages as Read

- Sets the status of all new and unread messages in the current folder to read.

F5 Folder Update Folder

- Checks whether new mail arrived in the currently selected folder.

  This is only available for &imap; folders.

&Ctrl;F5 Folder Update Folder and All Its Subfolders

- Checks whether new mail arrived in the currently selected folder and all of its subfolders.

  This is only available for &imap; folders.

Folder Move All to Trash

- Moves all of the messages in the selected folder into the trash folder.

  This is only available if the currently selected folder is not a trash folder. If the currently selected folder is a trash folder, you will see Empty Trash. Please see next section for details.

Folder Empty Trash

- Permanently deletes all messages.

  This is only available if the currently selected folder is a trash folder.

Folder Archive Folder...

- Brings up a dialog to allow you to create an archive of the currently selected folder. Please see Folder Archive for details.

Folder Delete Folder

- Removes the selected folder and all its contents, including subfolders.

  Please note that there is no way to access the contents of a folder after it has been removed.

&Ctrl;* Folder Remove Duplicate Messages

- Searches the folder for duplicate messages and deletes them.

Folder Apply All Filters On Folder

- Applies all configured filters on the currently selected folder. Please see Filter dialog for more information on filters.

Folder Prefer HTML to Plain Text

- If enabled then &html; messages in this folder will be shown using &html; rendering.

  For security reasons, we recommend to only activate this for folders which only contain trusted messages.

Folder Load External References

- If you have &html; messages enabled (see above), then you have the option to enable this to have images and resources linked from the web will load automatically.

  For security reasons, we recommend to only activate this for folders which only contain trusted messages.

Folder Mailing List Management...

- This opens up the mailing list management dialog. Please see Mailing List dialog for more information on mailing lists.

Folder Assign Shortcut...

- This allows you to assign a keyboard shortcut to the currently selected folder.

### Message Menu

&Ctrl;N Message New Message...

- Opens the composer window so you can write a new message.

&Ctrl;&Shift;N Message New Message to Mailing-List...

- Opens the composer window so you can write a new mail. If the current folder holds a mailing list and has a posting address defined, this address will be the default To: address.

R Message Reply...

- Opens up the composer window, inserts the quoted text of the currently selected message and presets the To: field either with the mailing-list address (if you reply to a mailing-list message) or with the preferred reply address of the sender. If you want to control which address the To: field is preset with then you should use Reply Special. Your identity will automatically be set to the identity this message was originally sent to.

A Message Reply to All...

- Opens up the composer window, inserts the quoted text of the currently selected message and presets the To: field either with the mailing-list address (if you reply to a mailing-list message) or with the preferred reply address of the sender. The Copy to (CC): field is preset with the addresses of all other recipients of the currently selected message excluding your own address. Your identity will automatically be set to the identity this message was originally sent to.

&Shift;A Message Reply Special Reply to Author...

- Opens up the composer window, inserts the quoted text of the currently selected message and presets the To: field with the preferred reply address of the sender. Your identity will automatically be set to the identity this message was originally sent to.

L Message Reply Special Reply to Mailing-List...

- Opens up the composer window, inserts the quoted text of the currently selected message and presets the To: field with the mailing-list address. If you did not specify a mailing-list address for the currently selected folder and &kmail; cannot determine the posting address from the currently selected message then the To: field will be empty. Your identity will automatically be set to the identity this message was originally sent to.

&Shift;R Message Reply Special Reply Without Quote...

- Works just like Reply... except that the text of the currently selected message is not quoted.

Message Reply Special Reply With Custom Template

- Works just like Reply... with the option to select a custom template that has been configured in Custom Templates.

Message Reply Special Reply to All With Custom Template

- Works just like Reply to All... with the option to select a custom template that has been configured in Custom Templates.

&Shift;F Message Forward As Attachment

- Forwards the message to a new recipient. The message and its attachments will become an attachment of the new message. The original message headers will be included in the forwarded message as well.

F Message Forward Inline

- The message's text and some important header fields will be copied to the body of the new message with text marking the forwarded part. Attachments will be forwarded as attachments of the new message.

E Message Forward Redirect

- This works like forward, except that the message stays the same (even the From: field). The user who redirected the message is added in special header fields (`Redirect-From`, `Redirect-Date`, `Redirect-To`, &etc;).

Message Forward With Custom Template

- Works just like forward with the option to select a custom template that has been configured in the composer custom templates tab in Custom Templates.

Message Send Again...

- Opens a composer window with the currently selected message so it can be sent again.

  This is only available for messages which you have sent or, more precisely, for messages which have the sent status.

T Message Edit Message

- Edits the selected message if it is editable.

  Only messages in the outbox and drafts folder can be edited.

Message Mailing List

- Offers several options for mailing list messages.

  The current working folder must be configured as a mailing list for this to be available. Please see Folder Properties Mailing List for information on setting up mailing lists.

  The following options are available to mailing list folders:

  - Post New Message(email) will presets the To: with the address configured in Post to List.

  - Request Help(email) will presets the To: with the address configured in Post to List and `help` word in the Subject: field.

  - Subscribe to List(web) will open your default web browser to the subscribe website of the configured mailing list.

  - Subscribe to List(email) will presets the To: with the mailing list subscription address and `subscribe` word in the Subject: field.

  - Unsubscribe from List(web) will open your default web browser to the unsubscribe website of the configured mailing list.

  - Unsubscribe from List(email) will presets the To: with the mailing list subscription address and `unsubscribe` word in the Subject: field.

Message Copy Message To

- Copies the selected messages to a specified folder, you can choose from recent folders, local folders, or a specific account folder.

Message Move Message To

- The same as copy message to, except you permanently move the selected messages to a specified folder.

Message Mark Message

- Allows you to change the status of the selected message to one of the following states:

  Status | Symbol | Meaning
  &Ctrl;R Mark Message as Read |  | The message has been read.
  &Ctrl;U Mark Message as Unread |  | The message has not been read yet.
  Mark Message as Important |  | This status will not automatically be set by &kmail;. You can use it freely to mark messages that are in some way important to you.
  Remove Important Mark |  | Remove a previously set important flag from the message.
  Mark Message as Action Item |  | This status will not automatically be set by &kmail;. Use this to mark messages that are action items ⪚ To-do list.
  Remove Action Item Mark |  | Remove a previously set action item mark from the message.

Message Mark Thread

- Allows you to change the status of all messages in a thread as follows:

  Status | Symbol | Meaning
  Mark Thread as Read |  | The entire thread has been read.
  Mark Thread as Unread |  | The thread has not been read yet.
  Mark Thread as Important |  | This status will not automatically be set by &kmail;. You can use it freely to mark threads that are in some way important to you.
  Remove Important Thread Mark |  | Remove a previously set important flag from the thread.
  Mark Thread as Action Item |  | This status will not automatically be set by &kmail;. Use this to mark threads that are action items ⪚ To-do list.
  Remove Action Item Thread Mark |  | Remove a previously set action item mark from the thread.
  Watch Thread |  | Set the watched thread status, which allows you to easily view threads your interested in by selecting Watched status in the drop down box found into Quick Search Bar.
  Ignore Thread |  | Allows you to ignore entire threads.

Message Create Filter

- Opens up the Filter dialog with a new filter added. This new filter is based on fields of the current mail, depending on which sub menu item you select from:

  - Filter on Subject...
  - Filter on From...
  - Filter on To...
  - Filter on Mailing-List...(currently selected mail must be a mailing list for this to be available)

Message Apply Filter

- Allows you to Apply all Filters. If you have spam filtering set up through Anti-Spam Wizard the options Classify as Spam and Classify as NOT Spam will be available for spam filtering.

Message Create To-do/Reminder

- Brings up the &kontact; To-do/Reminder dialog with options to add the selected email as a link, inline, or inline without attachments.

Message Add Note...

- Brings up the &kontact; Note dialog to add a note to the selected email.

### Tools Menu

S Tools Find Messages...

- Opens up a search window that lets you search for messages with certain characteristics, ⪚ a certain subject. Please see Filter Criteria for details on search options.

  Your search results will display in the text area, at which point you can open the Open Search Folder or highlight the desired message and select Open Message.

Tools Certificate Manager...

- Starts &kleopatra;, the &kde; certificate manager.

Tools GnuPG Log Viewer

- Starts KWatchGnuPG, a tool to present the debug output of the GnuPG application. If signing, encryption, or verification mysteriously stop working, you might find out why by looking at this log.

Tools Edit "Out of Office" Replies...

- Launch the Configure "Out of Office" Replies dialog, which allows you to set-up vacation notifications.

  Out of Office reply functionality relies on server-side filtering. To be able to use it you need to configure the Filtering tab (see option relevant to kolab server) of your &imap; account set-up.

Tools Debug Sieve...

- Launch the Sieve Diagnostics dialog. This is useful to debug sieve if you are having problems with it.

  You must have sieve support on your email server.

Tools Filter Log Viewer...

- Opens up the viewer window for the filter log; there you find some options to control the logging of the filtering process. In the log you will find valuable information about what filter rules were used, what was the result of the evaluation of those rules, and which filter actions were applied to a message.

Tools Import Wizard...

- Brings up the Import Wizard dialog which assists in easily importing settings and email. Please see Import Wizard for details.

Tools Export &kmail; Data...

- Brings up the PIM Setting Exporter dialog which assists in easily exporting your settings and email. Please see pimsettingexporter for details.

Tools Account Wizard...

- Brings up the Account Wizard dialog which assists in easily setting up accounts. Please see Account Wizard for details.

Tools Anti-Spam Wizard...

- Brings up the Anti-Spam Wizard which can help you to set up spam filtering. Please see Anti-Spam Wizard for details.

Tools Anti-Virus Wizard...

- Brings up the Anti-Virus Wizard which can help you to set up scanning messages for viruses. Please see Anti-Virus Wizard for details.

### Settings Menu

If the menu item you are looking for is missing, please see Settings Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

&Ctrl;H Settings Show Quick Search bar

- Allows you to enable the Quick Search bar, which allows you to quickly search for messages matching a search text, is visible.

Settings Configure Filters...

- Opens the Message Filters window.

Settings Manage Sieve Scripts...

- If your mail server supports sieve (server side filtering), you would configure your scripts here.

Settings Configure Automatic Archiving...

- Brings up the dialog to set up automatic archiving. Please see Automatic Archiving for details.

Settings Configure Send Later Agent...

- Brings up a dialog that allows you to modify and remove emails that have been sent using the send later feature. Please see Send Later Agent for details.

Settings Configure Folder Archive Agent...

- Brings up a dialog that allows you to configure accounts to use the folder archive agent feature with. Please see Folder Archive Agent for details.

Settings Configure Notifications...

- Opens a dialog that lets you configure what happens when new mail arrives, ⪚ play a sound, display a popup, &etc;

### Help Menu

Help Menu of the &kde; Fundamentals.

## The &kmail; Composer Window

### Message Menu

&Ctrl;N Message New Composer

- Opens up a new composer window.

Message New Main Window

- Creates a new main window.

Message New AddressBook Contact

- Brings up the &kontact; New Contact Dialog to add a new contact your addressbook.

&Ctrl;Return Message Send Mail

- Sends the message immediately. If you use &SMTP; to send your messages and the &SMTP; server is not reachable, the message will be put into the outbox and you will get an error message. After the connection issues are resolved, you can send the messages in the outbox using File Send Queued Messages.

Message Send Mail Via

- Allows you to select which outgoing mail server you wish to use to send the message.

Message Send Later

- Brings up the send later dialog. Please see Send Later for details.

Message Send Later Via

- Allows you to choose which outgoing account to send your send later configured message.

Message Save as File

- Saves the message as a text document.

&Ctrl;S Message Save as Draft

- Save the message in the drafts folder so you can later edit and send it.

Message Save as Template

- Allows you to save your message as a template. Please see Compose from templates for details on templates.

Message Insert Text File...

- Inserts a text file into the message text, starting at the cursor position.

Message Insert Recent Text File...

- Allows you to choose from a list of recently inserted text files to insert into your message. Select Clear List to clear the list.

&Ctrl;P Message Print...

- Prints the current text.

&Ctrl;W Message Close

- Closes this composer window.

### Edit Menu

If the menu item you are looking for is missing, please see Edit Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

&Ctrl;&Shift;O Edit Paste as Quotation

- Pastes the text from the clipboard marked as quotation.

Edit Paste as Attachment

- Pastes the text from the clipboard as an attachment.

&Ctrl;&Shift;V Edit Paste Without Formatting

- Pastes the text from the clipboard exactly as is, with no formatting.

Edit Clean Spaces

- This replaces multiple line breaks or spaces with single line breaks or spaces. It works on the current selection or the complete message text if there is no selection.

Edit Add Quote Characters

- Prepends the selected text with quotation marks.

Edit Remove Quote Characters

- Removes the left-most quotation marks from the selected text.

Edit Uppercase

- Convert the selected text to uppercase.

Edit Lowercase

- Convert the selected text to lowercase.

Edit Insert Special Characters

- It allows you to insert special character in composer.

### View Menu

This menu lets you toggle the display of the header fields and other options in the composer window.

Currently visible items will have a checkmark shown next to their name in the menu.

Options available are:

- All Fields

- Identity

- Dictionary

- Sent-Mail folder

- Mail Transport

- From

- Reply To

- Subject

Please see Composer Headers for details on these options.

View Use Fixed Font

- Uses a fixed width (monospaced) font to display the currently edited message. The font to be used can be configured in the Appearance section of &kmail;'s configuration dialog.

View Snippets

- Displays a column on the right side of the composer window that allows you to use and create snippets. Please see Snippets for more information.

View Translator

- Displays the translator tool at the bottom of the composer window. Please see Using the Translator for more information.

### Options Menu

This menu lets you toggle various options for the current message.

Currently used options will have a checkmark shown next to their name in the menu.

Options Urgent

- Sets the priority of the message to Urgent. The receiver's email client has to support this or it will have no effect. &kmail; itself does not support priorities for incoming messages.

Options Request Disposition Notification

- If you choose this option, you request a confirmation email once your message is downloaded and read by its recipient. This has to be supported and enabled by the receiver's email client in order to work.

  See configure-security-reading-mdns for background information and ways to customize the read receipts that &kmail; itself sends.

Options Sign Message

- Digitally sign the message using OpenPGP. You can learn more about this in the chapter on OpenPGP.

Options Encrypt Message

- Encrypt the message using OpenPGP. You can learn more about this in the chapter on OpenPGP.

Options Cryptographic Message Format

- Choose the cryptographic message format to use to digitally sign and/or encrypt the message in. Please see Cryptographic Message Formats for more information.

Options Rich Text Editing

- Enables Rich Text/&html; editing.

Options Encoding

- Set the charset encoding of this message. The chosen encoding will appear in the header of the outgoing mail. You can use Auto for almost all cases, &kmail; will tell you if you need to select a different encoding manually.

Options Wordwrap

- Toggles the automatic wordwrap. It may be useful to turn it off if you want to paste long lines that should not wrap.

Options Automatic Spellchecking

- Toggles automatic spellchecking.

### Attach Menu

This menu lets you select attachment options.

Attach Append Signature

- Appends your signature (footer) to the end of the message. Please see Configure Identity Signature for details on configuring your signature.

Attach Prepend Signature

- Prepends your signature (header) to the beginning of the message. Please see Configure Identity Signature for details on configuring your signature.

Attach Append Signature At Cursor Position

- Appends your signature to the current location of your cursor to the message. Please see Configure Identity Signature for details on configuring your signature.

Attach Attach Public Key...

- Opens the Attach Public OpenPGP Key dialog. Please see Configure Identity Cryptography OpenPGP Signing for details.

Attach Attach My Public Key

- Attaches your GnuPG public key to your message.

Attach Attach Attach File...

- Attaches one or more files to the current message. By default attachments are not encrypted, please see Cryptographic Message Formats for information on encryption and attachments.

Attach Attach Attach Own vCard

- Attaches your vCard to the current message.

Attach Remove Attachment

- Removes the attachment that is selected in the attachment part of the composer.

Attach Save Attachment As...

- Saves the attachment that is selected in the attachment window to a file.

Attach Attachment Properties

- Displays the properties of the attachment that is selected in the attachment window. It also allows you to sign/encrypt the attachment. Please see Configure Security Composing to set up encryption.

### Tools Menu

If the menu item you are looking for is missing, please see Tools Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

Tools Select Recipients...

- Opens up the Select Recipient dialog with your personal contacts to select from.

Tools Addressbook...

- Opens up &kaddressbook;.

Tools Save Distribution List...

- Opens a dialog that allows you to save groups of contacts.

### Settings Menu

If the menu item you are looking for is missing, please see Settings Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

Settings Spellchecker...

- Allows you to configure &sonnet;, &kde;'s spellchecker.

### Help Menu

Help Menu of the &kde; Fundamentals.